home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DATABASE / PGP21.ZIP;1 / PGPDOC2.DOC < prev    next >
Encoding:
Text File  |  1992-12-07  |  110.1 KB  |  2,279 lines

  1.  
  2.  
  3.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm             Page 1
  4.  
  5.  
  6.  
  7.  
  8.                           Phil's Pretty Good Software
  9.                                     Presents
  10.       
  11.                                       ===
  12.                                       PGP
  13.                                       ===
  14.       
  15.                               Pretty Good Privacy
  16.                       Public Key Encryption for the Masses
  17.       
  18.       
  19.                            -------------------------
  20.                                 PGP User's Guide
  21.                            Volume II: Special Topics
  22.                            -------------------------
  23.                               by Philip Zimmermann
  24.                                 Revised 3 Dec 92
  25.       
  26.       
  27.                            PGP Version 2.1 - 6 Dec 92
  28.                               Software Written by
  29.                                Philip Zimmermann
  30.                                       with
  31.                 Hal Finney, Branko Lankester, and Peter Gutmann
  32.       
  33.       
  34.       
  35.       
  36.      Synopsis:  PGP uses public-key encryption to protect E-mail and data
  37.      files.  Communicate securely with people you've never met, with no
  38.      secure channels needed for prior exchange of keys.  PGP is well
  39.      featured and fast, with sophisticated key management, digital
  40.      signatures, data compression, and good ergonomic design.
  41.       
  42.       
  43.      Software and documentation (c) Copyright 1990-1992 Philip Zimmermann. 
  44.      For information on PGP licensing, distribution, copyrights, patents,
  45.      trademarks, liability limitations, and export controls, see the
  46.      "Legal Issues" section.
  47.       
  48.       
  49.  
  50.  
  51.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm             Page 2
  52.  
  53.  
  54.  
  55.  
  56.       
  57.      Contents
  58.      ========
  59.       
  60.      Quick Overview
  61.      Special Topics
  62.        Selecting Keys via Key ID
  63.        Separating Signatures from Messages
  64.        Decrypting the Message and Leaving the Signature on it
  65.        Sending ASCII Text Files Across Different Machine Environments
  66.        Leaving No Traces of Plaintext on the Disk
  67.        Displaying Decrypted Plaintext on Your Screen
  68.        Making a Message For Her Eyes Only
  69.        Preserving the Original Plaintext Filename
  70.        Editing Your User ID or Pass Phrase
  71.        Editing the Trust Parameters for a Public Key
  72.        Checking If Everything is OK on Your Public Key Ring
  73.        Verifying a Public Key Over the Phone
  74.        Using PGP as a Unix-style Filter
  75.        PGP Returns Exit Status to the Shell
  76.        Environmental Variable for Pass Phrase
  77.        Setting Configuration Parameters: CONFIG.TXT
  78.          TMP - Directory Pathname for Temporary Files
  79.          LANGUAGE - Foreign Language Selector
  80.          MYNAME - Default User ID for Making Signatures
  81.          TEXTMODE - Assuming Plaintext is a Text File
  82.          CHARSET - Specifies Local Character Set for Text Files
  83.          ARMOR - Enable ASCII Armor Output
  84.          ARMORLINES - Size of ASCII Armor Multipart Files
  85.          KEEPBINARY - Keep Binary Ciphertext Files After Decrypting
  86.          VERBOSE - Enable Verbose Mode
  87.          COMPRESS - Enable Compression
  88.          BAKRING - Filename for Backup Secret Keyring
  89.          COMPLETES_NEEDED - Number of Completely Trusted Introducers Needed
  90.          MARGINALS_NEEDED - Number of Marginally Trusted Introducers Needed
  91.          CERT_DEPTH - How Deep May Introducers Be Nested
  92.          PAGER - Selects Shell Command to Display Plaintext Output
  93.          SHOWPASS - Echo Pass Phrase to User
  94.          TZFIX - Timezone Adjustment
  95.          CLEARSIG - Enable Signed Messages to be Encapsulated as Clear Text
  96.        Protecting Against Bogus Timestamps
  97.        A Peek Under the Hood
  98.          Random Numbers
  99.          PGP's Conventional Encryption Algorithm
  100.          Data Compression
  101.          Message Digests and Digital Signatures
  102.        Compatibility with Previous Versions of PGP
  103.      Vulnerabilities
  104.        Compromised Pass Phrase and Secret Key
  105.        Public Key Tampering
  106.        "Not Quite Deleted" Files
  107.        Viruses and Trojan Horses
  108.        Physical Security Breach
  109.        Tempest Attacks
  110.        Exposure on Multi-user Systems
  111.        Traffic Analysis
  112.  
  113.  
  114.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm             Page 3
  115.  
  116.  
  117.  
  118.  
  119.        Cryptanalysis
  120.      Legal Issues
  121.        Trademarks, Copyrights, and Warranties
  122.        Patent Rights on the Algorithms
  123.        Licensing and Distribution
  124.        Export Controls
  125.      Recommended Readings
  126.      To Contact the Author
  127.      Where to Get PGP
  128.       
  129.       
  130.  
  131.  
  132.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm             Page 4
  133.  
  134.  
  135.  
  136.  
  137.       
  138.      Quick Overview
  139.      =============
  140.       
  141.      Pretty Good(tm) Privacy (PGP), from Phil's Pretty Good Software, is a
  142.      high security cryptographic software application for MSDOS, Unix,
  143.      VAX/VMS, and other computers.  PGP combines the convenience of the
  144.      Rivest-Shamir-Adleman (RSA) public key cryptosystem with the speed of
  145.      conventional cryptography, message digests for digital signatures,
  146.      data compression before encryption, good ergonomic design, and
  147.      sophisticated key management. 
  148.       
  149.      This volume II of the PGP User's Guide covers advanced topics about
  150.      PGP that were not covered in the "PGP User's Guide, Volume I:
  151.      Essential Topics".  You should first read the Essential Topics
  152.      volume, or this manual won't make much sense to you.  Reading this
  153.      Special Topics volume is optional.
  154.       
  155.       
  156.       
  157.      Special Topics
  158.      ===============
  159.       
  160.       
  161.      Selecting Keys via Key ID
  162.      -------------------------
  163.       
  164.      In all commands that let the user type a user ID or fragment of a
  165.      user ID to select a key, the hexadecimal key ID may be used instead. 
  166.      Just use the key ID, with a prefix of "0x", in place of the user ID. 
  167.      For example:
  168.       
  169.          pgp -kv 0x67F7
  170.       
  171.      This would display all keys that had 67F7 as part of their key IDs.
  172.       
  173.      This feature is particularly useful if you have two different keys
  174.      from the same person, with the same user ID.  You can unambiguously
  175.      pick which key you want by specifying the key ID.
  176.       
  177.       
  178.      Separating Signatures from Messages
  179.      -----------------------------------
  180.       
  181.      Normally, signature certificates are physically attached to the text
  182.      they sign.  This makes it convenient in simple cases to check
  183.      signatures.  It is desirable in some circumstances to have signature
  184.      certificates stored separately from the messages they sign.  It is
  185.      possible to generate signature certificates that are detached from
  186.      the text they sign.  To do this, combine the 'b' (break) option with
  187.      the 's' (sign) option.  For example:
  188.       
  189.          pgp -sb letter.txt
  190.       
  191.      This example produces an isolated signature certificate in a file
  192.      called "letter.sig".  The contents of letter.txt are not appended to
  193.  
  194.  
  195.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm             Page 5
  196.  
  197.  
  198.  
  199.  
  200.      the signature certificate.
  201.       
  202.      After creating the signature certificate file (letter.sig in the
  203.      above example), send it along with the original text file to the
  204.      recipient.  The recipient must have both files to check the signature
  205.      integrity.  When the recipient attempts to process the signature
  206.      file, PGP notices that there is no text in the same file with the
  207.      signature and prompts the user for the filename of the text. Only
  208.      then can PGP properly check the signature integrity.  If the
  209.      recipient knows in advance that the signature is detached from the
  210.      text file, she can specify both filenames on the command line:
  211.       
  212.          pgp letter.sig letter.txt
  213.      or: pgp letter letter.txt
  214.       
  215.      PGP will not have to prompt for the text file name in this case.
  216.       
  217.      A detached signature certificate is useful if you want to keep the
  218.      signature certificate in a separate certificate log.  A detached
  219.      signature of an executable program is also useful for detecting a
  220.      subsequent virus infection.  It is also useful if more than one party
  221.      must sign a document such as a legal contract, without nesting
  222.      signatures.  Each person's signature is independent.
  223.       
  224.      If you receive a ciphertext file that has the signature certificate
  225.      glued to the message, you can still pry the signature certificate
  226.      away from the message during the decryption.  You can do this with
  227.      the -b option during decrypt, like so:
  228.       
  229.          pgp -b letter
  230.       
  231.      This decrypts the letter.pgp file and if there is a signature in it,
  232.      PGP checks the signature and detaches it from the rest of the
  233.      message, storing it in the file letter.sig.
  234.       
  235.       
  236.      Decrypting the Message and Leaving the Signature on it
  237.      ------------------------------------------------------
  238.       
  239.      Usually, you want PGP to completely unravel a ciphertext file,
  240.      decrypting it and checking the nested signature if there is one,
  241.      peeling away the layers until you are left with only the original
  242.      plaintext file.
  243.       
  244.      But sometimes you want to decrypt an encrypted file, and leave the
  245.      inner signature still attached, so that you are left with a decrypted
  246.      signed message.  This may be useful if you want to send a copy of a
  247.      signed document to a third party, perhaps re-enciphering it.  For
  248.      example, suppose you get a message signed by Charlie, encrypted to
  249.      you.  You want to decrypt it, and, leaving Charlie's signature on it,
  250.      you want to send it to Alice, perhaps re-enciphering it with Alice's
  251.      public key.  No problem.  PGP can handle that.
  252.       
  253.      To simply decrypt a message and leave the signature on it intact,
  254.      type:
  255.       
  256.  
  257.  
  258.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm             Page 6
  259.  
  260.  
  261.  
  262.  
  263.          pgp -d letter
  264.       
  265.      This decrypts letter.pgp, and if there is an inner signature, it is
  266.      left intact with the decrypted plaintext in the output file.
  267.       
  268.      Now you can archive it, or maybe re-encrypt it and send it to someone
  269.      else.
  270.       
  271.       
  272.       
  273.      Sending ASCII Text Files Across Different Machine Environments
  274.      --------------------------------------------------------------
  275.       
  276.      You may use PGP to encrypt any kind of plaintext file, binary 8-bit
  277.      data or ASCII text.  Probably the most common usage of PGP will be for
  278.      E-mail, when the plaintext is ASCII text.  
  279.       
  280.      ASCII text is sometimes represented differently on different
  281.      machines.  For example, on an MSDOS system, all lines of ASCII text
  282.      are terminated with a carriage return followed by a linefeed.  On a
  283.      Unix system, all lines end with just a linefeed.  On a Macintosh, all
  284.      lines end with just a carriage return.  This is a sad fact of life.
  285.       
  286.      Normal unencrypted ASCII text messages are often automatically
  287.      translated to some common "canonical" form when they are transmitted
  288.      from one machine to another.  Canonical text has a carriage return
  289.      and a linefeed at the end of each line of text.  For example, the
  290.      popular KERMIT communication protocol can convert text to canonical
  291.      form when transmitting it to another system.  This gets converted
  292.      back to local text line terminators by the receiving KERMIT.  This
  293.      makes it easy to share text files across different systems.
  294.       
  295.      But encrypted text cannot be automatically converted by a
  296.      communication protocol, because the plaintext is hidden by
  297.      encipherment.  To remedy this inconvenience, PGP lets you specify
  298.      that the plaintext should be treated as ASCII text (not binary data)
  299.      and should be converted to canonical text form before it gets
  300.      encrypted.  At the receiving end, the decrypted plaintext is
  301.      automatically converted back to whatever text form is appropriate for
  302.      the local environment.
  303.       
  304.      To make PGP assume the plaintext is text that should be converted to
  305.      canonical text before encryption, just add the "t" option when
  306.      encrypting or signing a message, like so:
  307.       
  308.         pgp -et message.txt her_userid
  309.       
  310.      This mode is automatically turned off if PGP detects that the
  311.      plaintext file contains what it thinks is non-text binary data.
  312.       
  313.      For PGP users that use non-English 8-bit character sets, when PGP 
  314.      converts text to canonical form, it may convert data from the local
  315.      character set into the LATIN1 (ISO 8859-1 Latin Alphabet 1) character
  316.      set, depending on the setting of the CHARSET parameter in the PGP
  317.      configuration file.  LATIN1 is a superset of ASCII, with extra
  318.      characters added for many European languages.
  319.  
  320.  
  321.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm             Page 7
  322.  
  323.  
  324.  
  325.  
  326.       
  327.       
  328.       
  329.      Leaving No Traces of Plaintext on the Disk
  330.      ------------------------------------------
  331.       
  332.      After PGP makes a ciphertext file for you, you can have PGP
  333.      automatically overwrite the plaintext file and delete it, leaving no
  334.      trace of plaintext on the disk so that no one can recover it later
  335.      using a disk block scanning utility.  This is useful if the plaintext
  336.      file contains sensitive information that you don't want to keep
  337.      around.
  338.       
  339.      To wipe out the plaintext file after producing the ciphertext file,
  340.      just add the "w" (wipe) option when encrypting or signing a message,
  341.      like so:
  342.       
  343.          pgp -esw message.txt her_userid
  344.       
  345.      This example creates the ciphertext file "message.pgp", and the 
  346.      plaintext file "message.txt" is destroyed beyond recovery.
  347.       
  348.      Obviously, you should be careful with this option.  Also note that
  349.      this will not wipe out any fragments of plaintext that your word
  350.      processor might have created on the disk while you were editing the
  351.      message before running PGP.  Most word processors create backup
  352.      files, scratch files, or both.  Also, it overwrites the file only
  353.      once, which is enough to thwart conventional disk recovery efforts,
  354.      but not enough to withstand a determined and sophisticated effort to
  355.      recover the faint magnetic traces of the data using special disk
  356.      recovery hardware.
  357.       
  358.       
  359.       
  360.      Displaying Decrypted Plaintext on Your Screen
  361.      ---------------------------------------------
  362.       
  363.      To view the decrypted plaintext output on your screen (like the
  364.      Unix-style "more" command), without writing it to a file, use the -m
  365.      (more) option while decrypting:
  366.       
  367.           pgp -m ciphertextfile
  368.       
  369.      This displays the decrypted plaintext display on your screen one
  370.      screenful at a time.
  371.       
  372.       
  373.       
  374.      Making a Message For Her Eyes Only
  375.      ----------------------------------
  376.       
  377.      To specify that the recipient's decrypted plaintext will be shown
  378.      ONLY on her screen and cannot be saved to disk, add the -m option:
  379.       
  380.           pgp -sem message.txt her_userid
  381.       
  382.  
  383.  
  384.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm             Page 8
  385.  
  386.  
  387.  
  388.  
  389.      Later, when the recipient decrypts the ciphertext with her secret key
  390.      and pass phrase, the plaintext will be displayed on her screen but
  391.      will not be saved to disk.  The text will be displayed as it would if
  392.      she used the Unix "more" command, one screenful at a time.  If she
  393.      wants to read the message again, she will have to decrypt the
  394.      ciphertext again.
  395.       
  396.      This feature is the safest way for you to prevent your sensitive
  397.      message from being inadvertently left on the recipient's disk.  This
  398.      feature was added at the request of a user who wanted to send
  399.      intimate messages to his lover, but was afraid she might accidentally
  400.      leave the decrypted messages on her husband's computer.
  401.       
  402.       
  403.       
  404.      Preserving the Original Plaintext Filename
  405.      ------------------------------------------
  406.       
  407.      Normally, PGP names the decrypted plaintext output file with a name
  408.      similar to the input ciphertext filename, but dropping the 
  409.      extension.  Or, you can override that convention by specifying an
  410.      output plaintext filename on the command line with the -o option.
  411.      For most E-mail, this is a reasonable way to name the plaintext file,
  412.      because you get to decide its name when you decipher it, and your
  413.      typical E-mail messages often come from useless original plaintext
  414.      filenames like "to_phil.txt".  
  415.       
  416.      But when PGP encrypts a plaintext file, it always saves the original
  417.      filename and attaches it to the plaintext before it compresses and
  418.      encrypts the plaintext.  Normally, this hidden original filename is
  419.      discarded by PGP when it decrypts, but you can tell PGP you want to
  420.      preserve the original plaintext filename and use it as the name of
  421.      the decrypted plaintext output file.  This is useful if PGP is used
  422.      to on files whose names are important to preserve.
  423.       
  424.      To recover the original plaintext filename while decrypting, add 
  425.      the -p option, like so:
  426.       
  427.           pgp -p ciphertextfile
  428.       
  429.      I usually don't use this option, because if I did, about half of my
  430.      incoming E-mail would decrypt to the same plaintext filenames of
  431.      "to_phil.txt" or "prz.txt".
  432.       
  433.       
  434.       
  435.      Editing Your User ID or Pass Phrase
  436.      -----------------------------------
  437.       
  438.      Sometimes you may need to change your pass phrase, perhaps because
  439.      someone looked over your shoulder while you typed it in.  
  440.       
  441.      Or you may need to change your user ID, because you got married and
  442.      changed your name, or maybe you changed your E-mail address.  Or
  443.      maybe you want to add a second or third user ID to your key, because
  444.      you may be known by more than one name or E-mail address or job
  445.  
  446.  
  447.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm             Page 9
  448.  
  449.  
  450.  
  451.  
  452.      title.  PGP lets you attach more than one user ID to your key, any
  453.      one of which may be used to look up your key on the key ring.
  454.       
  455.      To edit your userid or pass phrase for your secret key:
  456.       
  457.           pgp -ke userid [keyring]
  458.       
  459.      PGP prompts you for a new user ID or a new pass phrase.
  460.       
  461.       
  462.       
  463.      Editing the Trust Parameters for a Public Key
  464.      ---------------------------------------------
  465.       
  466.      Sometimes you need to alter the trust parameters for a public key on
  467.      your public key ring.  For a discussion on what these trust
  468.      parameters mean, see the section "How Does PGP Keep Track of Which
  469.      Keys are Valid?" in the Essential Topics volume of the PGP User's
  470.      Guide.
  471.       
  472.      To edit the trust parameters for a public key:
  473.       
  474.           pgp -ke userid [keyring]
  475.       
  476.       
  477.       
  478.      Checking If Everything is OK on Your Public Key Ring
  479.      ----------------------------------------------------
  480.       
  481.      Normally, PGP automatically checks any new keys or signatures on your
  482.      public key ring and updates all the trust parameters and validity
  483.      scores.  In theory, it keeps all the key validity status information
  484.      up to date as material is added to or deleted from your public key
  485.      ring.  But perhaps you may want to explicitly force PGP to perform a
  486.      comprehensive analysis of your public key ring, checking all the
  487.      certifying signatures, checking the trust parameters, updating all
  488.      the validity scores, and checking your own ultimately-trusted key
  489.      against a backup copy on a write-protected floppy disk.  It may be a
  490.      good idea to do this hygienic maintenance periodically to make sure
  491.      nothing is wrong with your public key ring.  To force PGP to perform
  492.      a full analysis of your public key ring, use the -kc (key ring check)
  493.      command:
  494.       
  495.           pgp -kc
  496.       
  497.      You can also make PGP check all the signatures for just a single
  498.      selected public key by:
  499.       
  500.           pgp -kc userid [keyring]
  501.       
  502.      For further information on how the backup copy of your own key is
  503.      checked, see the description of the BAKRING parameter in the
  504.      configuration file section of this manual.
  505.       
  506.       
  507.       
  508.  
  509.  
  510.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 10
  511.  
  512.  
  513.  
  514.  
  515.      Verifying a Public Key Over the Phone
  516.      -------------------------------------
  517.       
  518.      If you get a public key from someone that is not certified by anyone
  519.      you trust, how can you tell if it's really their key?  The best way
  520.      to verify an uncertified key is to verify it over some independent
  521.      channel other than the one you received the key through.  One
  522.      convenient way to tell, if you know this person and would recognize
  523.      them on the phone, is to call them and verify their key over the
  524.      telephone.  Rather than reading their whole tiresome (ASCII-armored)
  525.      key to them over the phone, you can just read their key's
  526.      "fingerprint" to them.  To see this fingerprint, use the -kvc
  527.      command:
  528.       
  529.           pgp -kvc userid [keyring]
  530.       
  531.      This will display the key with the 16-byte digest of the public key
  532.      components.  Read this 16-byte fingerprint to the key's owner on the
  533.      phone, while she checks it against her own, using the same -kvc
  534.      command at her end.  
  535.       
  536.      You can both verify each other's keys this way, and then you can sign
  537.      each other's keys with confidence.  This is a safe and convenient way
  538.      to get the key trust network started for your circle of friends.
  539.       
  540.       
  541.       
  542.      Using PGP as a Unix-style Filter
  543.      --------------------------------
  544.       
  545.      Unix fans are accustomed to using Unix "pipes" to make two
  546.      applications work together.  The output of one application can be
  547.      directly fed through a pipe to be read as input to another
  548.      application.  For this to work, the applications must be capable of
  549.      reading the raw material from "standard input" and writing the
  550.      finished output to "standard output".  PGP can operate in this mode.
  551.      If you don't understand what this means, then you probably don't need
  552.      this feature.
  553.       
  554.      To use a Unix-style filter mode, reading from standard input and
  555.      writing to standard output, add the -f option, like so:
  556.       
  557.           pgp -feast her_userid <inputfile >outputfile
  558.       
  559.      This feature makes it easier to make PGP work with electronic mail
  560.      applications.
  561.       
  562.      When using PGP in filter mode to decrypt a ciphertext file, you may
  563.      find it useful to use the PGPPASS environmental variable to hold the
  564.      pass phrase, so that you won't be prompted for it.  The PGPPASS
  565.      feature is explained below.
  566.       
  567.       
  568.       
  569.      PGP Returns Exit Status to the Shell
  570.      ------------------------------------
  571.  
  572.  
  573.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 11
  574.  
  575.  
  576.  
  577.  
  578.       
  579.      To facilitate running PGP in "batch" mode, such as from an MSDOS
  580.      ".bat" file or from a Unix shell script, PGP returns an error exit
  581.      status to the shell.  An exit status code of zero means normal exit,
  582.      while a nonzero exit status indicates some kind of error occurred.
  583.      Different error exit conditions return different exit status codes to
  584.      the shell.
  585.       
  586.       
  587.       
  588.      Environmental Variable for Pass Phrase
  589.      --------------------------------------
  590.       
  591.      Normally, PGP prompts the user to type a pass phrase whenever PGP 
  592.      needs a pass phrase to unlock a secret key.  But it is possible to
  593.      store the pass phrase in an environmental variable from your
  594.      operating system's command shell.  The environmental variable PGPPASS
  595.      can be used to hold the pass phrase that PGP will attempt to use
  596.      first.  If the pass phrase stored in PGPPASS is incorrect, PGP 
  597.      recovers by prompting the user for the correct pass phrase.
  598.       
  599.      For example, on MSDOS, the shell command:
  600.       
  601.          SET PGPPASS=zaphod beeblebrox for president
  602.       
  603.      would eliminate the prompt for the pass phrase if the pass phrase
  604.      were indeed "zaphod beeblebrox for president". 
  605.       
  606.      This dangerous feature makes your life more convenient if you have to
  607.      regularly deal with a large number of incoming messages addressed to
  608.      your secret key, by eliminating the need for you to repeatedly type
  609.      in your pass phrase every time you run PGP.
  610.       
  611.      I added this feature because of popular demand.  However, this is a
  612.      somewhat dangerous feature, because it keeps your precious pass
  613.      phrase stored somewhere other than just in your brain.  Even worse,
  614.      if you are particularly reckless, it may even be stored on a disk on
  615.      the same computer as your secret key.  It would be particularly
  616.      dangerous and stupid if you were to install this command in a batch
  617.      or script file, such as the MSDOS AUTOEXEC.BAT file.  Someone could
  618.      come along on your lunch hour and steal both your secret key ring and
  619.      the file containing your pass phrase.  
  620.       
  621.      I can't emphasize the importance of this risk enough.  If you are
  622.      contemplating using this feature, be sure to read the sections
  623.      "Exposure on Multi-user Systems" and "How to Protect Secret Keys from
  624.      Disclosure" in this volume and in the Essential Topics volume of the 
  625.      PGP User's Guide.
  626.       
  627.      If you must use this feature, the safest way to do it would be to
  628.      just manually type in the shell command to set PGPPASS every time you
  629.      boot your machine to start using PGP, and then erase it or turn off
  630.      your machine when you are done.  And you should definitely never do
  631.      it in an environment where someone else may have access to your
  632.      machine.  Someone could come along and simply ask your computer to
  633.      display the contents of PGPPASS.
  634.  
  635.  
  636.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 12
  637.  
  638.  
  639.  
  640.  
  641.       
  642.       
  643.       
  644.      Setting Configuration Parameters: CONFIG.TXT
  645.      ============================================
  646.       
  647.      PGP has a number of user-settable parameters that can be defined in a
  648.      special configuration text file called "config.txt", in the directory
  649.      pointed to by the shell environmental variable PGPPATH.  Having a
  650.      configuration file enables the user to define various flags and
  651.      parameters for PGP without the burden of having to always define
  652.      these parameters in the PGP command line.
  653.       
  654.      Configuration parameters may be assigned integer values, character
  655.      string values, or on/off values, depending on what kind of
  656.      configuration parameter it is.  A sample configuration file is
  657.      provided with PGP, so you can see some examples.
  658.       
  659.      In the configuration file, blank lines are ignored, as is anything
  660.      following the '#' comment character.  Keywords are not
  661.      case-sensitive.  
  662.       
  663.      Here is a short sample fragment of a typical configuration file:
  664.       
  665.         # TMP is the directory for PGP scratch files, such as a RAM disk.
  666.         TMP = "e:\"    # Can be overridden by environment variable TMP.
  667.         Armor = on     # Use -a flag for ASCII armor whenever applicable.
  668.         # CERT_DEPTH is how deeply introducers may introduce introducers.
  669.         cert_depth = 3
  670.       
  671.      If some configuration parameters are not defined in the configuration
  672.      file, or if there is no configuration file, or if PGP can't find the
  673.      configuration file, the values for the configuration parameters
  674.      default to some reasonable value.
  675.       
  676.      Note that it is also possible to set these same configuration
  677.      parameters directly from the PGP command line, by preceding the
  678.      parameter setting with a "+" character.  For example, the following
  679.      two PGP commands produce the same effect:
  680.       
  681.           pgp -e +armor=on message.txt smith
  682.      or:  pgp -ea message.txt smith
  683.       
  684.       
  685.      The following is a summary of the various parameters than may be
  686.      defined in the configuration file.
  687.       
  688.       
  689.      TMP - Directory Pathname for Temporary Files
  690.      --------------------------------------------
  691.       
  692.      Default setting:  TMP = ""
  693.       
  694.      The configuration parameter TMP specifies what directory to use for
  695.      PGP's temporary scratch files.  The best place to put them is on a
  696.      RAM disk, if you have one.  That speeds things up quite a bit, and
  697.  
  698.  
  699.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 13
  700.  
  701.  
  702.  
  703.  
  704.      increases security somewhat.  If TMP is undefined, the temporary
  705.      files go in the current directory.  If the shell environmental
  706.      variable TMP is defined, PGP instead uses that to specify where the
  707.      temporary files should go.
  708.       
  709.       
  710.      LANGUAGE - Foreign Language Selector
  711.      ------------------------------------
  712.       
  713.      Default setting:  LANGUAGE = "en"
  714.       
  715.      PGP displays various prompts, warning messages, and advisories to the
  716.      user on the screen.  For example, messages such as "File not found.",
  717.      or "Please enter your pass phrase:".  These messages are normally in
  718.      English.  But it is possible to get PGP to display its messages to
  719.      the user in other languages, without having to modify the PGP
  720.      executable program.
  721.       
  722.      A number of people in various countries have translated all of PGP's
  723.      display messages, warnings, and prompts into their native languages. 
  724.      These hundreds of translated message strings have been placed in a
  725.      special text file called "language.txt", distributed with the PGP
  726.      release.  The messages are stored in this file in English, Spanish,
  727.      Dutch, German, French, Italian, Russian, Latvian, and Lithuanian. 
  728.      Other languages may be added later.  
  729.       
  730.      The configuration parameter LANGUAGE specifies what language to
  731.      display these messages in.  LANGUAGE may be set to "en" for English,
  732.      "es" for Spanish, "de" for German, "nl" for Dutch, "fr" for French,
  733.      "it" for Italian, "ru" for Russian, "lt3" for Lithuanian, "lv" for
  734.      Latvian, "esp" for Esperanto.  For example, if this line appeared in
  735.      the configuration file:
  736.       
  737.         LANGUAGE = "fr"
  738.       
  739.      PGP would select French as the language for its display messages.
  740.      The default setting is English.
  741.       
  742.      When PGP needs to display a message to the user, it looks in the
  743.      "language.txt" file for the equivalent message string in the selected
  744.      foreign language and displays that translated message to the user.
  745.      If PGP can't find the language string file, or if the selected
  746.      language is not in the file, or if that one phrase is not translated
  747.      into the selected language in the file, or if that phrase is missing
  748.      entirely from the file, PGP displays the message in English.
  749.       
  750.      To conserve disk space, most foreign translations are not included 
  751.      in the standard PGP release package, but are available separately.
  752.       
  753.       
  754.      MYNAME - Default User ID for Making Signatures
  755.      ----------------------------------------------
  756.       
  757.      Default setting:  MYNAME = ""
  758.       
  759.      The configuration parameter MYNAME specifies the default user ID to
  760.  
  761.  
  762.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 14
  763.  
  764.  
  765.  
  766.  
  767.      use to select the secret key for making signatures.  If MYNAME is not
  768.      defined, the most recent secret key you installed on your secret key
  769.      ring will be used.  The user may also override this setting by
  770.      specifying a user ID on the PGP command line with the -u option.
  771.       
  772.       
  773.      TEXTMODE - Assuming Plaintext is a Text File
  774.      --------------------------------------------
  775.       
  776.      Default setting:  TEXTMODE = off
  777.       
  778.      The configuration parameter TEXTMODE is equivalent to the -t command
  779.      line option.  If enabled, it causes PGP to assume the plaintext is a
  780.      text file, not a binary file, and converts it to "canonical text"
  781.      before encrypting it.  Canonical text has a carriage return and a
  782.      linefeed at the end of each line of text.
  783.       
  784.      This mode will be automatically turned off if PGP detects that the
  785.      plaintext file contains what it thinks is non-text binary data.
  786.       
  787.      For VAX/VMS systems, the current version of PGP defaults TEXTMODE=ON.
  788.       
  789.      For further details, see the section "Sending ASCII Text Files Across
  790.      Different Machine Environments".
  791.       
  792.       
  793.      CHARSET - Specifies Local Character Set for Text Files
  794.      ------------------------------------------------------
  795.       
  796.      Default setting:  CHARSET = NOCONV
  797.       
  798.      Because PGP must process messages in many non-English languages with
  799.      non-ASCII character sets, you may have a need to tell PGP what local
  800.      character set your machine uses.  This determines what character
  801.      conversions are performed when converting plaintext files to and from
  802.      canonical text format.  This is only a concern if you are in a
  803.      non-English non-ASCII environment.
  804.       
  805.      The configuration parameter CHARSET selects the local character set. 
  806.      The choices are NOCONV (no conversion), LATIN1 (ISO 8859-1 Latin
  807.      Alphabet 1), KOI8 (used by most Russian Unix systems), ALT_CODES
  808.      (used by Russian MSDOS systems), ASCII, and CP850 (used by most
  809.      western European languages on standard MSDOS PCs).
  810.       
  811.      LATIN1 is the internal representation used by PGP for canonical text,
  812.      so if you select LATIN1, no conversion is done.  Note also that PGP
  813.      treats KOI8 as LATIN1, even though it is a completely different
  814.      character set (Russian), because trying to convert KOI8 to either
  815.      LATIN1 or CP850 would be futile anyway.  This means that setting
  816.      CHARSET to NOCONV, LATIN1, or KOI8 are all equivalent to PGP.
  817.       
  818.      If you use MSDOS and expect to send or receive traffic in western
  819.      European languages, set CHARSET = "CP850".  This will make PGP
  820.      convert incoming canonical text messages from LATIN1 to CP850 after
  821.      decryption.  If you use the -t (textmode) option to convert to
  822.      canonical text, PGP will convert your CP850 text to LATIN1 before
  823.  
  824.  
  825.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 15
  826.  
  827.  
  828.  
  829.  
  830.      encrypting it.
  831.       
  832.      For further details, see the section "Sending ASCII Text Files Across
  833.      Different Machine Environments".
  834.       
  835.       
  836.      ARMOR - Enable ASCII Armor Output
  837.      ---------------------------------
  838.       
  839.      Default setting:  ARMOR = off
  840.       
  841.      The configuration parameter ARMOR is equivalent to the -a command
  842.      line option.  If enabled, it causes PGP to emit ciphertext or keys in
  843.      ASCII Radix-64 format suitable for transporting through E-mail
  844.      channels.  Output files are named with the ".asc" extension.
  845.       
  846.      If you tend to use PGP mostly for E-mail, it may be a good idea to
  847.      enable this parameter.
  848.       
  849.      For further details, see the section "Sending Ciphertext Through
  850.      E-mail Channels: Radix-64 Format" in the Essential Topics volume. 
  851.       
  852.       
  853.      ARMORLINES - Size of ASCII Armor Multipart Files
  854.      ------------------------------------------------
  855.       
  856.      Default setting:  ARMORLINES = 720
  857.       
  858.      When PGP creates a very large ".asc" radix-64 file for sending
  859.      ciphertext or keys through the E-mail, it breaks the file up into
  860.      separate chunks small enough to send through Internet mail
  861.      utilities.  Normally, Internet mailers prohibit files larger than
  862.      about 50000 bytes, which means that if we restrict the number of
  863.      lines to about 720, we'll be well within the limit.  The file chunks
  864.      are named with suffixes ".as1", ".as2", ".as3", ... 
  865.       
  866.      The configuration parameter ARMORLINES specifies the maximum number
  867.      of lines to make each chunk in a multipart ".asc" file sequence.  If
  868.      you set it to zero, PGP will not break up the file into chunks.
  869.       
  870.      Fidonet email files usually have an upper limit of about 32K bytes,
  871.      so 450 lines would be appropriate for Fidonet environments.
  872.       
  873.      For further details, see the section "Sending Ciphertext Through
  874.      E-mail Channels: Radix-64 Format" in the Essential Topics volume.
  875.       
  876.       
  877.      KEEPBINARY - Keep Binary Ciphertext Files After Decrypting
  878.      ----------------------------------------------------------
  879.       
  880.      Default setting:  KEEPBINARY = off
  881.       
  882.      When PGP reads a ".asc" file, it recognizes that the file is in
  883.      radix-64 format and will convert it back to binary before processing
  884.      as it normally does, producing as a by-product a ".pgp" ciphertext
  885.      file in binary form.  After further processing to decrypt the ".pgp"
  886.  
  887.  
  888.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 16
  889.  
  890.  
  891.  
  892.  
  893.      file, the final output file will be in normal plaintext form.
  894.       
  895.      You may want to delete the binary ".pgp" intermediate file, or you
  896.      may want PGP to delete it for you automatically.  You can still rerun
  897.      PGP on the original ".asc" file.
  898.       
  899.      The configuration parameter KEEPBINARY enables or disables keeping
  900.      the intermediate ".pgp" file during decryption.
  901.       
  902.      For further details, see the section "Sending Ciphertext Through
  903.      E-mail Channels: Radix-64 Format" in the Essential Topics volume.
  904.       
  905.       
  906.      VERBOSE - Enable Verbose Mode
  907.      -----------------------------
  908.       
  909.      Default setting:  VERBOSE = off
  910.       
  911.      The configuration parameter VERBOSE enables "verbose" diagnostic
  912.      messages during PGP's operation, which is mainly useful for debugging
  913.      PGP.  Otherwise, there is not much use for it.
  914.       
  915.       
  916.      COMPRESS - Enable Compression
  917.      -----------------------------
  918.       
  919.      Default setting:  COMPRESS = on
  920.       
  921.      The configuration parameter COMPRESS enables or disables data
  922.      compression before encryption.  It is used mainly for debugging PGP. 
  923.      Normally, PGP attempts to compress the plaintext before it encrypts
  924.      it.  Generally, you should leave this alone and let PGP attempt to
  925.      compress the plaintext.
  926.       
  927.       
  928.      COMPLETES_NEEDED - Number of Completely Trusted Introducers Needed
  929.      ------------------------------------------------------------------
  930.       
  931.      Default setting:  COMPLETES_NEEDED = 1
  932.       
  933.      The configuration parameter COMPLETES_NEEDED specifies the minimum
  934.      number of completely trusted introducers required to fully certify a
  935.      public key on your public key ring.  This gives you a way of tuning
  936.      PGP's skepticism.
  937.       
  938.      For further details, see the section "How Does PGP Keep Track of 
  939.      Which Keys are Valid?" in the Essential Topics volume.
  940.       
  941.       
  942.      MARGINALS_NEEDED - Number of Marginally Trusted Introducers Needed
  943.      ------------------------------------------------------------------
  944.       
  945.      Default setting:  MARGINALS_NEEDED = 2
  946.       
  947.      The configuration parameter MARGINALS_NEEDED specifies the minimum
  948.      number of marginally trusted introducers required to fully certify a
  949.  
  950.  
  951.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 17
  952.  
  953.  
  954.  
  955.  
  956.      public key on your public key ring.  This gives you a way of tuning
  957.      PGP's skepticism.
  958.       
  959.      For further details, see the section "How Does PGP Keep Track of 
  960.      Which Keys are Valid?" in the Essential Topics volume.
  961.       
  962.       
  963.      CERT_DEPTH - How Deep May Introducers Be Nested
  964.      -----------------------------------------------
  965.       
  966.      Default setting:  CERT_DEPTH = 4
  967.       
  968.      The configuration parameter CERT_DEPTH specifies how many levels deep
  969.      you may nest introducers to certify other introducers to certify
  970.      public keys on your public key ring.  For example, If CERT_DEPTH is
  971.      set to 1, there may only be one layer of introducers below your own
  972.      ultimately-trusted key.  If that were the case, you would be required
  973.      to directly certify the public keys of all trusted introducers on
  974.      your key ring.  If you set CERT_DEPTH to 0, you could have no
  975.      introducers at all, and you would have to directly certify each and
  976.      every key on your public key ring in order to use it.  The minimum
  977.      CERT_DEPTH is 0, the maximum is 8.
  978.       
  979.      For further details, see the section "How Does PGP Keep Track of 
  980.      Which Keys are Valid?" in the Essential Topics volume.
  981.       
  982.       
  983.      BAKRING - Filename for Backup Secret Keyring
  984.      --------------------------------------------
  985.       
  986.      Default setting:  BAKRING = ""
  987.       
  988.      All of the key certification that PGP does on your public key ring
  989.      ultimately depends on your own ultimately-trusted public key (or
  990.      keys).  To detect any tampering of your public key ring, PGP must
  991.      check that your own key has not been tampered with.  To do this, PGP
  992.      must compare your public key against a backup copy of your secret key
  993.      on some tamper-resistant media, such as a write-protected floppy
  994.      disk.  A secret key contains all the information that your public key
  995.      has, plus some secret components.  This means PGP can check your
  996.      public key against a backup copy of your secret key.
  997.       
  998.      The configuration parameter BAKRING specifies what pathname to use
  999.      for PGP's trusted backup copy of your secret key ring.  On MSDOS, you
  1000.      could set it to "a:\secring.pgp" to point it at a write-protected
  1001.      backup copy of your secret key ring on your floppy drive.  This check
  1002.      is performed only when you execute the PGP -kc option to check your
  1003.      whole public key ring.
  1004.       
  1005.      If BAKRING is not defined, PGP will not check your own key against
  1006.      any backup copy.
  1007.       
  1008.      For further details, see the sections "How to Protect Public Keys
  1009.      from Tampering" and "How Does PGP Keep Track of Which Keys are
  1010.      Valid?" in the Essential Topics volume.
  1011.       
  1012.  
  1013.  
  1014.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 18
  1015.  
  1016.  
  1017.  
  1018.  
  1019.       
  1020.      PAGER - Selects Shell Command to Display Plaintext Output
  1021.      ---------------------------------------------------------
  1022.       
  1023.      Default setting:  PAGER = ""
  1024.       
  1025.      PGP lets you view the decrypted plaintext output on your screen (like
  1026.      the Unix-style "more" command), without writing it to a file, if you
  1027.      use the -m (more) option while decrypting.  This displays the
  1028.      decrypted plaintext display on your screen one screenful at a time.
  1029.       
  1030.      If you prefer to use a fancier page display utility, rather than
  1031.      PGP's built-in one, you can specify the name of a shell command that
  1032.      PGP will invoke to display your plaintext output file.  The
  1033.      configuration parameter PAGER specifies the shell command to invoke
  1034.      to display the file.  For example:
  1035.       
  1036.         PAGER = "more"
  1037.       
  1038.      However, if the sender specified that this file is for your eyes
  1039.      only, and may not be written to disk, PGP always uses its own
  1040.      built-in display function.
  1041.       
  1042.      For further details, see the section "Displaying Decrypted Plaintext 
  1043.      on Your Screen".
  1044.       
  1045.       
  1046.      SHOWPASS - Echo Pass Phrase to User
  1047.      -----------------------------------
  1048.       
  1049.      Default setting:  SHOWPASS = off
  1050.       
  1051.      Normally, PGP does not let you see your pass phrase as you type it
  1052.      in.  This makes it harder for someone to look over your shoulder
  1053.      while you type and learn your pass phrase.  But some typing-impaired
  1054.      people have problems typing their pass phrase without seeing what
  1055.      they are typing, and they may be typing in the privacy of their own
  1056.      homes.  So they asked if PGP can be configured to let them see what
  1057.      they type when they type in their pass phrase.
  1058.       
  1059.      The configuration parameter SHOWPASS enables PGP to echo your typing 
  1060.      during pass phrase entry.
  1061.       
  1062.       
  1063.      TZFIX - Timezone Adjustment
  1064.      ---------------------------
  1065.       
  1066.      Default setting:  TZFIX = 0
  1067.       
  1068.      PGP provides timestamps for keys and signature certificates in
  1069.      Greenwich Mean Time (GMT), or Coordinated Universal Time (UTC), which
  1070.      means the same thing for our purposes.  When PGP asks the system for
  1071.      the time of day, the system is supposed to provide it in GMT.  
  1072.       
  1073.      But sometimes, because of improperly configured MSDOS systems, the
  1074.      system time is returned in US Pacific Standard Time time plus 8
  1075.  
  1076.  
  1077.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 19
  1078.  
  1079.  
  1080.  
  1081.  
  1082.      hours.  Sounds weird, doesn't it?  Perhaps because of some sort of US
  1083.      west-coast jingoism, MSDOS presumes local time is US Pacific time,
  1084.      and pre-corrects Pacific time to GMT.  This adversely affects the
  1085.      behavior of the internal MSDOS GMT time function that PGP calls. 
  1086.      However, if your MSDOS environmental variable TZ is already properly
  1087.      defined for your timezone, this corrects the misconception MSDOS has
  1088.      that the whole world lives on the US west coast.  
  1089.       
  1090.      The configuration parameter TZFIX specifies the number of hours to
  1091.      add to the system time function to get GMT, for GMT timestamps on
  1092.      keys and signatures.  If the MSDOS environmental variable TZ is
  1093.      defined properly, you can leave TZFIX=0.  Unix systems usually
  1094.      shouldn't need to worry about setting TZFIX at all.  But if you are
  1095.      using some other obscure operating system that doesn't know about
  1096.      GMT, you may have to use TZFIX to adjust the system time to GMT. 
  1097.       
  1098.      On MSDOS systems that do not have TZ defined in the environment, you
  1099.      should make TZFIX=0 for California, -1 for Colorado, -2 for Chicago,
  1100.      -3 for New York, -8 for London, -9 for Amsterdam.  In the summer,
  1101.      TZFIX should be manually decremented from these values.  What a mess.
  1102.       
  1103.      It would be much cleaner to set your MSDOS environmental variable TZ
  1104.      in your AUTOEXEC.BAT file, and not use the TZFIX correction.  Then
  1105.      MSDOS gives you good GMT timestamps, and will handle daylight savings
  1106.      time adjustments for you.  Here are some sample lines to insert into
  1107.      AUTOEXEC.BAT, depending on your time zone:
  1108.       
  1109.      For Los Angeles:  SET TZ=PST8PDT
  1110.      For Denver:       SET TZ=MST7MDT
  1111.      For Arizona:      SET TZ=MST7
  1112.         (Arizona never uses daylight savings time)
  1113.      For Chicago:      SET TZ=CST6CDT
  1114.      For New York:     SET TZ=EST5EDT
  1115.      For London:       SET TZ=GMT0BST
  1116.      For Amsterdam:    SET TZ=MET-1DST
  1117.      For Moscow:       SET TZ=MSK-3MSD
  1118.      For Aukland:      SET TZ=NZT-13
  1119.       
  1120.       
  1121.      CLEARSIG - Enable Signed Messages to be Encapsulated as Clear Text
  1122.      ------------------------------------------------------------------
  1123.       
  1124.      Default setting:  CLEARSIG = off
  1125.       
  1126.      Normally, unencrypted PGP signed messages have a signature
  1127.      certificate prepended in binary form.  To send this through a 7-bit
  1128.      E-mail channel, radix-64 ASCII armor is applied (see the ARMOR
  1129.      parameter), rendering the message unreadable to casual human eyes,
  1130.      even though the message is not actually encrypted.  The recipient
  1131.      must use PGP to strip the armor off before reading the message.
  1132.       
  1133.      If the original plaintext message is in text (not binary) form, there
  1134.      is a way to send it through an E-mail channel in such a way that the
  1135.      ASCII armor is applied only to the binary signature certificate, but
  1136.      not to the plaintext message.  This makes it possible to read the
  1137.      signed message with human eyes, without the aid of PGP.  Of course,
  1138.  
  1139.  
  1140.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 20
  1141.  
  1142.  
  1143.  
  1144.  
  1145.      you still need PGP to actually check the signature.
  1146.       
  1147.      To enable this feature, set CLEARSIG=ON, and set ARMOR=ON (or use
  1148.      the -a option), and set TEXTMODE=ON (or use the -t option).  For
  1149.      example, you can set CLEARSIG directly from the command line:
  1150.       
  1151.           pgp -sta +clearsig=on message.txt
  1152.       
  1153.      This message representation is analogous to the MIC-CLEAR message type
  1154.      used in Internet Privacy Enhanced Mail (PEM).  It is important to
  1155.      note that since this method only applies ASCII armor to the binary
  1156.      signature certificate, and not to the message text itself, there is
  1157.      some risk that the unarmored message may suffer some accidental
  1158.      molestation while en route.  This can happen if it passes through
  1159.      some E-mail gateway that performs character set conversions, or in
  1160.      some cases extra spaces may be added to or stripped from the ends of
  1161.      lines.  If this occurs, the signature will fail to verify, which may
  1162.      give a false indication of intentional tampering.  But since PEM
  1163.      lives under a similar vulnerability, it seems worth having this
  1164.      feature despite the risks.
  1165.       
  1166.       
  1167.  
  1168.  
  1169.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 21
  1170.  
  1171.  
  1172.  
  1173.  
  1174.       
  1175.      Protecting Against Bogus Timestamps
  1176.      ===================================
  1177.       
  1178.      A somewhat obscure vulnerability of PGP involves dishonest users
  1179.      creating bogus timestamps on their own public key certificates and
  1180.      signatures.  You can skip over this section if you are a casual user
  1181.      and aren't deeply into obscure public key protocols.
  1182.       
  1183.      There's nothing to stop a dishonest user from altering the date and
  1184.      time setting of his own system's clock, and generating his own public
  1185.      key certificates and signatures that appear to have been created at a
  1186.      different time.  He can make it appear that he signed something
  1187.      earlier or later than he actually did, or that his public/secret key
  1188.      pair was created earlier or later.  This may have some legal or
  1189.      financial benefit to him, for example by creating some kind of 
  1190.      loophole that might allow him to repudiate a signature.
  1191.       
  1192.      A remedy for this could involve some trustworthy Certifying Authority
  1193.      or notary that would create notarized signatures with a trustworthy
  1194.      timestamp.  This might not necessarily require a centralized
  1195.      authority.  Perhaps any trusted introducer or disinterested party
  1196.      could serve this function, the same way real notary publics do now. 
  1197.      A public key certificate could be signed by the notary, and the
  1198.      trusted timestamp in the notary's signature would have some legal
  1199.      significance.  The notary could enter the signed certificate into a
  1200.      special certificate log controlled by the notary.  Anyone can read
  1201.      this log. 
  1202.       
  1203.      The notary could also sign other people's signatures, creating a
  1204.      signature certificate of a signature certificate.  This would serve
  1205.      as a witness to the signature the same way real notaries do now with
  1206.      paper.  Again, the notary could enter the detached signature
  1207.      certificate (without the actual whole document that was signed) into
  1208.      a log controlled by the notary.  The notary's signature would have a
  1209.      trusted timestamp, which might have greater credibility than the
  1210.      timestamp in the original signature.  A signature becomes "legal" if
  1211.      it is signed and logged by the notary.
  1212.       
  1213.      This problem of certifying signatures with notaries and trusted
  1214.      timestamps warrants further discussion.  This can of worms will not
  1215.      be fully covered here now.  There is a good treatment of this topic
  1216.      in Denning's 1983 article in IEEE Computer (see references).  There
  1217.      is much more detail to be worked out in these various certifying
  1218.      schemes.  This will develop further as PGP usage increases and other
  1219.      public key products develop their own certifying schemes.
  1220.       
  1221.       
  1222.  
  1223.  
  1224.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 22
  1225.  
  1226.  
  1227.  
  1228.  
  1229.       
  1230.      A Peek Under the Hood
  1231.      =====================
  1232.       
  1233.      Let's take a look at a few internal features of PGP.
  1234.       
  1235.       
  1236.      Random Numbers
  1237.      --------------
  1238.       
  1239.      PGP uses a cryptographically strong pseudorandom number generator for
  1240.      creating temporary conventional session keys.  The seed file for this
  1241.      is called  "randseed.bin".  It too can be kept in whatever directory
  1242.      is indicated by the PGPPATH environmental variable.  If this random
  1243.      seed file does not exist, it is automatically created and seeded with
  1244.      truly random numbers derived from timing your keystroke latencies.  
  1245.       
  1246.      This generator reseeds the disk file each time it is used by mixing
  1247.      in new key material partially derived with the time of day and other
  1248.      truly random sources.  It uses the conventional encryption algorithm
  1249.      as an engine for the random number generator.  The seed file contains
  1250.      both random seed material and random key material to key the
  1251.      conventional encryption engine for the random generator.
  1252.       
  1253.      If you feel uneasy about trusting any algorithmically derived random
  1254.      number source however strong, keep in mind that you already trust the
  1255.      strength of the same conventional cipher to protect your messages. 
  1256.      If it's strong enough for that, then it should be strong enough to
  1257.      use as a source of random numbers for temporary session keys.  Note
  1258.      that PGP still uses truly random numbers from physical sources
  1259.      (mainly keyboard timings) to generate long-term public/secret key
  1260.      pairs.
  1261.       
  1262.       
  1263.       
  1264.      PGP's Conventional Encryption Algorithm
  1265.      ---------------------------------------
  1266.       
  1267.      As described earlier, PGP "bootstraps" into a conventional single-key
  1268.      encryption algorithm by using a public key algorithm to encipher the
  1269.      conventional session key and then switching to fast conventional
  1270.      cryptography.  So let's talk about this conventional encryption
  1271.      algorithm.  It isn't the DES.
  1272.       
  1273.      The Federal Data Encryption Standard (DES) is a good algorithm for
  1274.      most commercial applications.  However, the Government does not trust
  1275.      the DES to protect its own classified data.  Perhaps this is because
  1276.      the DES key length is 56 bits, short enough for a brute force attack
  1277.      with a special purpose machine built from massive numbers of DES
  1278.      chips.  Also, Biham and Shamir have had some success recently on
  1279.      attacking the full 16-round DES.
  1280.       
  1281.      PGP does not use the DES as its conventional single-key algorithm to
  1282.      encrypt messages.  Instead, PGP uses a different conventional
  1283.      single-key block encryption algorithm, called IDEA(tm).  A future
  1284.      version of PGP may support the DES as an option, if enough users
  1285.  
  1286.  
  1287.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 23
  1288.  
  1289.  
  1290.  
  1291.  
  1292.      ask for it.  But I suspect IDEA is better than DES.
  1293.       
  1294.      For the cryptographically curious, the IDEA cipher has a 64-bit block
  1295.      size for the plaintext and the ciphertext.  It uses a key size of 128
  1296.      bits.  It is based on the design concept of "mixing operations from
  1297.      different algebraic groups".  It runs much faster in software than
  1298.      the DES.  Like the DES, it can be used in cipher feedback (CFB) and
  1299.      cipher block chaining (CBC) modes.  PGP uses it in 64-bit CFB mode.
  1300.       
  1301.      The IPES/IDEA block cipher was developed at ETH in Zurich by James L.
  1302.      Massey and Xuejia Lai, and published in 1990.  This is not a 
  1303.      "home-grown" algorithm.  Its designers have a distinguished
  1304.      reputation in the cryptologic community.  Early published papers on
  1305.      the algorithm called it IPES (Improved Proposed Encryption Standard),
  1306.      but they later changed the name to IDEA (International Data
  1307.      Encryption Algorithm).  So far, IDEA has resisted attack much better
  1308.      than other ciphers such as FEAL, REDOC-II, LOKI, Snefru and Khafre. 
  1309.      And preliminary evidence suggests that IDEA may be more resistant
  1310.      than the DES to Biham & Shamir's highly successful differential
  1311.      cryptanalysis attack.  Biham and Shamir have been examining the IDEA
  1312.      cipher for weaknesses, without success.  Academic cryptanalyst groups
  1313.      in Belgium, England, and Germany are also attempting to attack it, as
  1314.      well as the military services from several European countries.  As
  1315.      this new cipher continues to attract attack efforts from the most
  1316.      formidable quarters of the cryptanalytic world, confidence in IDEA is
  1317.      growing with the passage of time.
  1318.       
  1319.      A famous hockey player once said, "I try to skate to where I think
  1320.      the puck will be."  A lot of people are starting to feel that the
  1321.      days are numbered for the DES.  I'm skating toward IDEA.
  1322.       
  1323.      It is not ergonomically practical to use pure RSA with large keys to
  1324.      encrypt and decrypt long messages.  Absolutely no one does it that way
  1325.      in the real world.  But perhaps you are concerned that the whole
  1326.      package is weakened if we use a hybrid public-key and conventional
  1327.      scheme just to speed things up.  After all, a chain is only as strong
  1328.      as its weakest link.  Many people less experienced in cryptography
  1329.      mistakenly believe that RSA is intrinsically stronger than any
  1330.      conventional cipher.  It's not.  RSA can be made weak by using weak
  1331.      keys, and conventional ciphers can be made strong by choosing good
  1332.      algorithms.  It's usually difficult to tell exactly how strong a good
  1333.      conventional cipher is, without actually cracking it.  A really good
  1334.      conventional cipher might possibly be harder to crack than even a
  1335.      "military grade" RSA key.  The attraction of public key cryptography
  1336.      is not because it is intrinsically stronger than a conventional
  1337.      cipher-- its appeal is because it helps you manage keys more
  1338.      conveniently.
  1339.       
  1340.       
  1341.       
  1342.      Data Compression
  1343.      ----------------
  1344.       
  1345.      PGP normally compresses the plaintext before encrypting it.  It's too
  1346.      late to compress it after it has been encrypted; encrypted data is
  1347.      incompressible.  Data compression saves modem transmission time and
  1348.  
  1349.  
  1350.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 24
  1351.  
  1352.  
  1353.  
  1354.  
  1355.      disk space and more importantly strengthens cryptographic security.  
  1356.      Most cryptanalysis techniques exploit redundancies found in the
  1357.      plaintext to crack the cipher.  Data compression reduces this
  1358.      redundancy in the plaintext, thereby greatly enhancing resistance to 
  1359.      cryptanalysis.  It takes extra time to compress the plaintext, but 
  1360.      from a security point of view it seems worth it, at least in my 
  1361.      cautious opinion. 
  1362.       
  1363.      Files that are too short to compress or just don't compress well are
  1364.      not compressed by PGP.  
  1365.       
  1366.      If you prefer, you can use PKZIP to compress the plaintext before
  1367.      encrypting it.  PKZIP is a widely-available and effective MSDOS
  1368.      shareware compression utility from PKWare, Inc.  Or you can use ZIP,
  1369.      a PKZIP-compatible freeware compression utility on Unix and other
  1370.      systems, available from Jean-Loup Gailly.  There is some advantage in
  1371.      using PKZIP or ZIP in certain cases, because unlike PGP's built-in
  1372.      compression algorithm, PKZIP and ZIP have the nice feature of
  1373.      compressing multiple files into a single compressed file, which is
  1374.      reconstituted again into separate files when decompressed.  PGP will
  1375.      not try to compress a plaintext file that has already been
  1376.      compressed.  After decrypting, the recipient can decompress the
  1377.      plaintext with PKUNZIP.  If the decrypted plaintext is a PKZIP
  1378.      compressed file, PGP automatically recognizes this and advises the 
  1379.      recipient that the decrypted plaintext appears to be a PKZIP file.
  1380.       
  1381.      For the technically curious readers, the current version of PGP uses
  1382.      the freeware ZIP compression routines written by Jean-loup Gailly,
  1383.      Mark Adler, and Richard B. Wales.  This ZIP software uses
  1384.      functionally-equivalent compression algorithms as those used by
  1385.      PKWare's new PKZIP 2.0.  This ZIP compression software was selected
  1386.      for PGP mainly because of its free portable C source code
  1387.      availability, and because it has a really good compression ratio, and
  1388.      because it's fast.  
  1389.       
  1390.       
  1391.       
  1392.      Message Digests and Digital Signatures
  1393.      --------------------------------------
  1394.       
  1395.      To create a digital signature, PGP encrypts with your secret key. 
  1396.      But PGP doesn't actually encrypt your entire message with your secret
  1397.      key-- that would take too long.  Instead, PGP encrypts a "message
  1398.      digest".  
  1399.       
  1400.      The message digest is a compact (128 bit) "distillate" of your
  1401.      message, similar in concept to a checksum.  You can also think of it
  1402.      as a "fingerprint" of the message.  The message digest "represents"
  1403.      your message, such that if the message were altered in any way, a
  1404.      different message digest would be computed from it.  This makes it
  1405.      possible to detect any changes made to the message by a forger.  A
  1406.      message digest is computed using a cryptographically strong one-way
  1407.      hash function of the message.  It would be computationally infeasible
  1408.      for an attacker to devise a substitute message that would produce an
  1409.      identical message digest.  In that respect, a message digest is much
  1410.      better than a checksum, because it is easy to devise a different
  1411.  
  1412.  
  1413.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 25
  1414.  
  1415.  
  1416.  
  1417.  
  1418.      message that would produce the same checksum.  But like a checksum,
  1419.      you can't derive the original message from its message digest.  
  1420.       
  1421.      A message digest alone is not enough to authenticate a message.  The
  1422.      message digest algorithm is publicly known, and does not require
  1423.      knowledge of any secret keys to calculate.  If all we did was attach
  1424.      a message digest to a message, then a forger could alter a message
  1425.      and simply attach a new message digest calculated from the new
  1426.      altered message.  To provide real authentication, the sender has to
  1427.      encrypt (sign) the message digest with his secret key.  
  1428.       
  1429.      A message digest is calculated from the message by the sender.  The
  1430.      sender's secret key is used to encrypt the message digest and an
  1431.      electronic timestamp, forming a digital signature, or signature
  1432.      certificate.  The sender sends the digital signature along with the
  1433.      message.  The receiver receives the message and the digital
  1434.      signature, and recovers the original message digest from the digital
  1435.      signature by decrypting it with the sender's public key.  The
  1436.      receiver computes a new message digest from the message, and checks
  1437.      to see if it matches the one recovered from the digital signature.  If
  1438.      it matches, then that proves the message was not altered, and it came
  1439.      from the sender who owns the public key used to check the signature.
  1440.       
  1441.      A potential forger would have to either produce an altered message
  1442.      that produces an identical message digest (which is infeasible), or
  1443.      he would have to create a new digital signature from a different
  1444.      message digest (also infeasible, without knowing the true sender's
  1445.      secret key).
  1446.       
  1447.      Digital signatures prove who sent the message, and that the message
  1448.      was not altered either by error or design.  It also provides
  1449.      non-repudiation, which means the sender cannot easily disavow his
  1450.      signature on the message.
  1451.       
  1452.      Using message digests to form digital signatures has other advantages
  1453.      besides being faster than directly signing the entire actual message
  1454.      with the secret key.  Using message digests allows signatures to be
  1455.      of a standard small fixed size, regardless of the size of the actual
  1456.      message.  It also allows the software to check the message integrity
  1457.      automatically, in a manner similar to using checksums.  And it allows
  1458.      signatures to be stored separately from messages, perhaps even in a
  1459.      public archive, without revealing sensitive information about the
  1460.      actual messages, because no one can derive any message content from a
  1461.      message digest.
  1462.       
  1463.      The message digest algorithm used here is the MD5 Message Digest
  1464.      Algorithm, placed in the public domain by RSA Data Security, Inc.
  1465.      MD5's designer, Ronald Rivest, writes this about MD5:
  1466.       
  1467.      "It is conjectured that the difficulty of coming up with two messages
  1468.      having the same message digest is on the order of 2^64 operations,
  1469.      and that the difficulty of coming up with any message having a given
  1470.      message digest is on the order of 2^128 operations.  The MD5
  1471.      algorithm has been carefully scrutinized for weaknesses.  It is,
  1472.      however, a relatively new algorithm and further security analysis is
  1473.      of course justified, as is the case with any new proposal of this
  1474.  
  1475.  
  1476.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 26
  1477.  
  1478.  
  1479.  
  1480.  
  1481.      sort.  The level of security provided by MD5 should be sufficient for
  1482.      implementing very high security hybrid digital signature schemes
  1483.      based on MD5 and the RSA public-key cryptosystem."
  1484.       
  1485.       
  1486.       
  1487.      Compatibility with Previous Versions of PGP
  1488.      ===========================================
  1489.       
  1490.      I'm sorry, PGP version 2.0 is not compatible with PGP version 1.0.  
  1491.      If you have keys generated with version 1.0, you will have to
  1492.      generate new keys to use with this version.  This version of PGP uses
  1493.      all new algorithms for conventional cryptography, compression, and
  1494.      message digests, as well as using a much better approach to key
  1495.      management.  There were just too many changes to make it compatible
  1496.      with the old format messages, signatures, and keys.  Perhaps we could
  1497.      have provided a special conversion utility to convert old keys into
  1498.      new keys, but we were all tired and wanted to get the new release out
  1499.      the door.  Besides, converting the old keys into new keys would
  1500.      probably create more problems than it would solve, because we have
  1501.      changed to a new recommended uniform style for the user ID that
  1502.      includes the full name and E-mail address in a particular syntax.
  1503.       
  1504.      We made some effort to design the internal data structures of this
  1505.      version of PGP to be adaptable to future changes, so that hopefully
  1506.      you will not be required to discard and regenerate your keys in future
  1507.      versions.
  1508.       
  1509.       
  1510.  
  1511.  
  1512.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 27
  1513.  
  1514.  
  1515.  
  1516.  
  1517.       
  1518.      Vulnerabilities
  1519.      ===============
  1520.       
  1521.      No data security system is impenetrable.  PGP can be circumvented in
  1522.      a variety of ways.  In any data security system, you have to ask
  1523.      yourself if the information you are trying to protect is more
  1524.      valuable to your attacker than the cost of the attack.  This should
  1525.      lead you to protecting yourself from the cheapest attacks, while not
  1526.      worrying about the more expensive attacks.  
  1527.       
  1528.      Some of the discussion that follows may seem unduly paranoid, but
  1529.      such an attitude is appropriate for a reasonable discussion of
  1530.      vulnerability issues. 
  1531.       
  1532.       
  1533.      Compromised Pass Phrase and Secret Key
  1534.      --------------------------------------
  1535.       
  1536.      Probably the simplest attack is if you leave your pass phrase for
  1537.      your secret key written down somewhere.  If someone gets it and also
  1538.      gets your secret key file, they can read your messages and make
  1539.      signatures in your name.  
  1540.       
  1541.      Don't use obvious passwords that can be easily guessed, such as the
  1542.      names of your kids or spouse.  If you make your pass phrase a single
  1543.      word, it can be easily guessed by having a computer try all the words
  1544.      in the dictionary until it finds your password.  That's why a pass
  1545.      phrase is so much better than a password.  A more sophisticated
  1546.      attacker may have his computer scan a book of famous quotations to
  1547.      find your pass phrase.  An easy to remember but hard to guess pass
  1548.      phrase can be easily constructed by some creatively nonsensical
  1549.      sayings or very obscure literary quotes.  
  1550.       
  1551.      For further details, see the section "How to Protect Secret Keys from
  1552.      Disclosure" in the Essential Topics volume of the PGP User's Guide.
  1553.       
  1554.       
  1555.      Public Key Tampering
  1556.      --------------------
  1557.       
  1558.      A major vulnerability exists if public keys are tampered with.  This
  1559.      may be the most crucially important vulnerability of a public key
  1560.      cryptosystem, in part because most novices don't immediately
  1561.      recognize it.  The importance of this vulnerability, and appropriate
  1562.      hygienic countermeasures, are detailed in the section "How to Protect
  1563.      Public Keys from Tampering" in the Essential Topics volume.    
  1564.       
  1565.      To summarize:  When you use someone's public key, make certain it has
  1566.      not been tampered with.  A new public key from someone else should be
  1567.      trusted only if you got it directly from its owner, or if it has been
  1568.      signed by someone you trust.  Make sure no one else can tamper with
  1569.      your own public key ring.  Maintain physical control of both your
  1570.      public key ring and your secret key ring, preferably on your own
  1571.      personal computer rather than on a remote timesharing system.  Keep a
  1572.      backup copy of both key rings.
  1573.  
  1574.  
  1575.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 28
  1576.  
  1577.  
  1578.  
  1579.  
  1580.       
  1581.       
  1582.      "Not Quite Deleted" Files
  1583.      -------------------------
  1584.       
  1585.      Another potential security problem is caused by how most operating
  1586.      systems delete files.  When you encrypt a file and then delete the
  1587.      original plaintext file, the operating system doesn't actually
  1588.      physically erase the data.  It merely marks those disk blocks as
  1589.      deleted, allowing the space to be reused later.  It's sort of like
  1590.      discarding sensitive paper documents in the paper recycling bin
  1591.      instead of the paper shredder.  The disk blocks still contain the
  1592.      original sensitive data you wanted to erase, and will probably
  1593.      eventually be overwritten by new data at some point in the future. 
  1594.      If an attacker reads these deleted disk blocks soon after they have
  1595.      been deallocated, he could recover your plaintext. 
  1596.       
  1597.      In fact this could even happen accidentally, if for some reason
  1598.      something went wrong with the disk and some files were accidentally
  1599.      deleted or corrupted.  A disk recovery program may be run to recover
  1600.      the damaged files, but this often means some previously deleted files
  1601.      are resurrected along with everything else.  Your confidential files
  1602.      that you thought were gone forever could then reappear and be
  1603.      inspected by whomever is attempting to recover your damaged disk.  
  1604.      Even while you are creating the original message with a word
  1605.      processor or text editor, the editor may be creating multiple
  1606.      temporary copies of your text on the disk, just because of its
  1607.      internal workings.  These temporary copies of your text are deleted
  1608.      by the word processor when it's done, but these sensitive fragments
  1609.      are still on your disk somewhere.  
  1610.       
  1611.      Let me tell you a true horror story.  I had a friend, married with
  1612.      young children, who once had a brief and not very serious affair. 
  1613.      She wrote a letter to her lover on her word processor, and deleted
  1614.      the letter after she sent it.  Later, after the affair was over, the
  1615.      floppy disk got damaged somehow and she had to recover it because it
  1616.      contained other important documents.  She asked her husband to
  1617.      salvage the disk, which seemed perfectly safe because she knew she
  1618.      had deleted the incriminating letter.  Her husband ran a commercial
  1619.      disk recovery software package to salvage the files.  It recovered
  1620.      the files alright, including the deleted letter.  He read it, which 
  1621.      set off a tragic chain of events.  
  1622.       
  1623.      The only way to prevent the plaintext from reappearing is to somehow
  1624.      cause the deleted plaintext files to be overwritten.  Unless you know
  1625.      for sure that all the deleted disk blocks will soon be reused, you
  1626.      must take positive steps to overwrite the plaintext file, and also
  1627.      any fragments of it on the disk left by your word processor.  You can
  1628.      overwrite the original plaintext file after encryption by using the
  1629.      PGP -w (wipe) option.  You can take care of any fragments of the
  1630.      plaintext left on the disk by using any of the disk utilities
  1631.      available that can overwrite all of the unused blocks on a disk.  For
  1632.      example, the Norton Utilities for MSDOS can do this.
  1633.       
  1634.      Even if you overwrite the plaintext data on the disk, it may still be
  1635.      possible for a resourceful and determined attacker to recover the
  1636.  
  1637.  
  1638.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 29
  1639.  
  1640.  
  1641.  
  1642.  
  1643.      data.  Faint magnetic traces of the original data remain on the disk
  1644.      after it has been overwritten.  Special sophisticated disk recovery
  1645.      hardware can sometimes be used to recover the data.
  1646.       
  1647.       
  1648.      Viruses and Trojan Horses
  1649.      -------------------------
  1650.       
  1651.      Another attack could involve a specially-tailored hostile computer
  1652.      virus or worm that might infect PGP or your operating system.  This
  1653.      hypothetical virus could be designed to capture your pass phrase or
  1654.      secret key or deciphered messages, and covertly write the captured
  1655.      information to a file or send it through a network to the virus's
  1656.      owner.  Or it might alter PGP's behavior so that signatures are not
  1657.      properly checked.  This attack is cheaper than cryptanalytic attacks.
  1658.       
  1659.      Defending against this falls under the category of defending against
  1660.      viral infection generally.  There are some moderately capable
  1661.      anti-viral products commercially available, and there are hygienic
  1662.      procedures to follow that can greatly reduce the chances of viral
  1663.      infection.  A complete treatment of anti-viral and anti-worm
  1664.      countermeasures is beyond the scope of this document.  PGP has no
  1665.      defenses against viruses, and assumes your own personal computer is a
  1666.      trustworthy execution environment.  If such a virus or worm actually
  1667.      appeared, hopefully word would soon get around warning everyone.  
  1668.       
  1669.      Another similar attack involves someone creating a clever imitation
  1670.      of PGP that behaves like PGP in most respects, but doesn't work the
  1671.      way it's supposed to.  For example, it might be deliberately crippled
  1672.      to not check signatures properly, allowing bogus key certificates to
  1673.      be accepted.  This "Trojan horse" version of PGP is not hard for an
  1674.      attacker to create, because PGP source code is widely available, so
  1675.      anyone could modify the source code and produce a lobotomized zombie
  1676.      imitation PGP that looks real but does the bidding of its diabolical
  1677.      master.  This Trojan horse version of PGP could then be widely
  1678.      circulated, claiming to be from me.  How insidious.
  1679.       
  1680.      You should make an effort to get your copy of PGP from a reliable
  1681.      source, whatever that means.  Or perhaps from more than one
  1682.      independent source, and compare them with a file comparison utility.
  1683.       
  1684.      There are other ways to check PGP for tampering, using digital
  1685.      signatures.  If someone you trust signs the executable version of
  1686.      PGP, vouching for the fact that it has not been infected or tampered
  1687.      with, you can be reasonably sure that you have a good copy.  You
  1688.      could use an earlier trusted version of PGP to check the signature on
  1689.      a later suspect version of PGP.  But this will not help at all if
  1690.      your operating system is infected, nor will it detect if your
  1691.      original copy of PGP.EXE has been maliciously altered in such a way
  1692.      as to compromise its own ability to check signatures.  This test also
  1693.      assumes that you have a good trusted copy of the public key that you
  1694.      use to check the signature on the PGP executable.
  1695.       
  1696.       
  1697.      Physical Security Breach
  1698.      ------------------------
  1699.  
  1700.  
  1701.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 30
  1702.  
  1703.  
  1704.  
  1705.  
  1706.       
  1707.      A physical security breach may allow someone to physically acquire
  1708.      your plaintext files or printed messages.  A determined opponent
  1709.      might accomplish this through burglary, trash-picking, unreasonable
  1710.      search and seizure, or bribery, blackmail or infiltration of your
  1711.      staff.  Some of these attacks may be especially feasible against
  1712.      grassroots political organizations that depend on a largely volunteer
  1713.      staff.  It has been widely reported in the press that the FBI's
  1714.      COINTELPRO program used burglary, infiltration, and illegal bugging
  1715.      against antiwar and civil rights groups.  And look what happened at
  1716.      the Watergate Hotel.  
  1717.       
  1718.      Don't be lulled into a false sense of security just because you have
  1719.      a cryptographic tool.  Cryptographic techniques protect data only
  1720.      while it's encrypted-- direct physical security violations can still
  1721.      compromise plaintext data or written or spoken information.  
  1722.       
  1723.      This kind of attack is cheaper than cryptanalytic attacks on PGP.
  1724.       
  1725.       
  1726.      Tempest Attacks
  1727.      ---------------
  1728.       
  1729.      Another kind of attack that has been used by well-equipped opponents
  1730.      involves the remote detection of the electromagnetic signals from
  1731.      your computer.  This expensive and somewhat labor-intensive attack is
  1732.      probably still cheaper than direct cryptanalytic attacks.  An
  1733.      appropriately instrumented van can park near your office and remotely
  1734.      pick up all of your keystrokes and messages displayed on your
  1735.      computer video screen.  This would compromise all of your passwords,
  1736.      messages, etc.  This attack can be thwarted by properly shielding all
  1737.      of your computer equipment and network cabling so that it does not
  1738.      emit these signals.  This shielding technology is known as "Tempest",
  1739.      and is used by some Government agencies and defense contractors.  
  1740.      There are hardware vendors who supply Tempest shielding commercially,
  1741.      although it may be subject to some kind of Government licensing.  Now
  1742.      why do you suppose the Government would restrict access to Tempest
  1743.      shielding?
  1744.       
  1745.       
  1746.      Exposure on Multi-user Systems
  1747.      ------------------------------
  1748.       
  1749.      PGP was originally designed for a single-user MSDOS machine under
  1750.      your direct physical control.  I run PGP at home on my own PC, and
  1751.      unless someone breaks into my house or monitors my electromagnetic
  1752.      emissions, they probably can't see my plaintext files or secret keys. 
  1753.       
  1754.      But now PGP also runs on multi-user systems such as Unix and VAX/VMS.
  1755.      On multi-user systems, there are much greater risks of your plaintext
  1756.      or keys or passwords being exposed.  The Unix system administrator or
  1757.      a clever intruder can read your plaintext files, or perhaps even use
  1758.      special software to covertly monitor your keystrokes or read what's
  1759.      on your screen.  On a Unix system, any other user can read your
  1760.      environment information remotely by simply using the Unix "ps"
  1761.      command.  Similar problems exist for MSDOS machines connected on a
  1762.  
  1763.  
  1764.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 31
  1765.  
  1766.  
  1767.  
  1768.  
  1769.      local area network.  The actual security risk is dependent on your
  1770.      particular situation.  Some multi-user systems may be safe because
  1771.      all the users are trusted, or because they have system security
  1772.      measures that are safe enough to withstand the attacks available to
  1773.      the intruders, or because there just aren't any sufficiently
  1774.      interested intruders.  Some Unix systems are safe because they are
  1775.      only used by one user-- there are even some notebook computers
  1776.      running Unix.  It would be unreasonable to simply exclude PGP from
  1777.      running on all Unix systems.
  1778.       
  1779.      PGP is not designed to protect your data while it is in plaintext
  1780.      form on a compromised system.  Nor can it prevent an intruder from
  1781.      using sophisticated measures to read your secret key while it is
  1782.      being used.  You will just have to recognize these risks on
  1783.      multi-user systems, and adjust your expectations and behavior
  1784.      accordingly.  Perhaps your situation is such that you should consider
  1785.      only running PGP on an isolated single-user system under your direct
  1786.      physical control.  That's what I do, and that's what I recommend.
  1787.       
  1788.       
  1789.      Traffic Analysis
  1790.      ----------------
  1791.       
  1792.      Even if the attacker cannot read the contents of your encrypted
  1793.      messages, he may be able to infer at least some useful information by
  1794.      observing where the messages come from and where they are going, the
  1795.      size of the messages, and the time of day the messages are sent. 
  1796.      This is analogous to the attacker looking at your long distance phone
  1797.      bill to see who you called and when and for how long, even though the
  1798.      actual content of your calls is unknown to the attacker.  This is
  1799.      called traffic analysis.  PGP alone does not protect against traffic
  1800.      analysis.  Solving this problem would require specialized 
  1801.      communication protocols designed to reduce exposure to traffic
  1802.      analysis in your communication environment, possibly with some
  1803.      cryptographic assistance.
  1804.       
  1805.       
  1806.      Cryptanalysis
  1807.      -------------
  1808.       
  1809.      An expensive and formidable cryptanalytic attack could possibly be
  1810.      mounted by someone with vast supercomputer resources, such as a
  1811.      Government intelligence agency.  They might crack your RSA key by
  1812.      using some new secret factoring breakthrough.  Perhaps so, but it is
  1813.      noteworthy that the US Government trusts the RSA algorithm enough in
  1814.      some cases to use it to protect its own nuclear weapons, according to
  1815.      Ron Rivest.  And civilian academia has been intensively attacking it
  1816.      without success since 1978. 
  1817.       
  1818.      Perhaps the Government has some classified methods of cracking the
  1819.      IDEA(tm) conventional encryption algorithm used in PGP.  This is
  1820.      every cryptographer's worst nightmare.  There can be no absolute
  1821.      security guarantees in practical cryptographic implementations.  
  1822.       
  1823.      Still, some optimism seems justified.  The IDEA algorithm's designers
  1824.      are among the best cryptographers in Europe.  It has had extensive
  1825.  
  1826.  
  1827.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 32
  1828.  
  1829.  
  1830.  
  1831.  
  1832.      security analysis and peer review from some of the best cryptanalysts
  1833.      in the unclassified world.  It appears to have some design advantages
  1834.      over the DES in withstanding differential cryptanalysis, which has
  1835.      been used to crack the DES.  
  1836.       
  1837.      Besides, even if this algorithm has some subtle unknown weaknesses,
  1838.      PGP compresses the plaintext before encryption, which should greatly
  1839.      reduce those weaknesses.  The computational workload to crack it is
  1840.      likely to be much more expensive than the value of the message.
  1841.       
  1842.      If your situation justifies worrying about very formidable attacks of
  1843.      this caliber, then perhaps you should contact a data security
  1844.      consultant for some customized data security approaches tailored to
  1845.      your special needs.  Boulder Software Engineering, whose address and
  1846.      phone are given at the end of this document, can provide such
  1847.      services.
  1848.       
  1849.       
  1850.      In summary, without good cryptographic protection of your data
  1851.      communications, it may have been practically effortless and perhaps
  1852.      even routine for an opponent to intercept your messages, especially
  1853.      those sent through a modem or E-mail system.  If you use PGP and
  1854.      follow reasonable precautions, the attacker will have to expend far
  1855.      more effort and expense to violate your privacy. 
  1856.       
  1857.      If you protect yourself against the simplest attacks, and you feel
  1858.      confident that your privacy is not going to be violated by a
  1859.      determined and highly resourceful attacker, then you'll probably be
  1860.      safe using PGP.  PGP gives you Pretty Good Privacy.
  1861.       
  1862.       
  1863.  
  1864.  
  1865.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 33
  1866.  
  1867.  
  1868.  
  1869.  
  1870.       
  1871.      Legal Issues
  1872.      ============
  1873.       
  1874.       
  1875.      Trademarks, Copyrights, and Warranties
  1876.      --------------------------------------
  1877.       
  1878.      "Pretty Good Privacy", "Phil's Pretty Good Software", and the "Pretty
  1879.      Good" label for computer software and hardware products are all
  1880.      trademarks of Philip Zimmermann and Phil's Pretty Good Software.  PGP
  1881.      is (c) Copyright Philip R. Zimmermann, 1990-1992.  Philip Zimmermann
  1882.      also holds the copyright for the PGP User's Manual, as well as any
  1883.      foreign language translations of the manual or the software.
  1884.       
  1885.      The author assumes no liability for damages resulting from the use of
  1886.      this software, even if the damage results from defects in this
  1887.      software, and makes no representations concerning the merchantability
  1888.      of this software or its suitability for any specific purpose.  It is
  1889.      provided "as is" without express or implied warranty of any kind.
  1890.       
  1891.       
  1892.      Patent Rights on the Algorithms
  1893.      -------------------------------
  1894.       
  1895.      When I first released PGP, I half-expected to encounter some form of
  1896.      legal harassment from the Government.  Indeed, there has been legal 
  1897.      harrassment, but it hasn't come from the Government-- it has come
  1898.      from a private corporation.
  1899.       
  1900.      The RSA public key cryptosystem was developed at MIT with Federal
  1901.      funding from grants from the National Science Foundation and the
  1902.      Navy.  It is patented by MIT (U.S. patent #4,405,829, issued 20 Sep
  1903.      1983).  A company in California called Public Key Partners (PKP) holds
  1904.      the exclusive commercial license to sell and sub-license the RSA
  1905.      public key cryptosystem.  The author of this software implementation
  1906.      of the RSA algorithm is providing this implementation for educational
  1907.      use only.  Licensing this algorithm from PKP is the responsibility of
  1908.      you, the user, not Philip Zimmermann, the author of this software
  1909.      implementation.  The author assumes no liability for any patent
  1910.      infringement that may result from the unlicensed use by the user of
  1911.      the underlying RSA algorithm used in this software.  Foreign users
  1912.      should note that the RSA patent does not apply outside the US, and
  1913.      there is no RSA patent in any other country.  Federal agencies may
  1914.      use it because the Government paid for the development of RSA.  
  1915.       
  1916.      Unfortunately, PKP is not offering any licensing of their RSA patent
  1917.      to end users of PGP.  This essentially makes PGP contraband in the
  1918.      USA.  Jim Bidzos, president of PKP, threatened to take legal action
  1919.      against me unless I stop distributing PGP, until they can devise a
  1920.      licensing scheme for it.  I agreed to this, since PGP is already in
  1921.      wide circulation and waiting a while for a licensing arrangement from
  1922.      PKP seemed reasonable.  Mr. Bidzos assured me (he even used the word
  1923.      "promise") several times since the initial 5 June 91 release of PGP
  1924.      that they were working on a licensing scheme for PGP.  Apparently, my
  1925.      release of PGP helped provide the impetus for them to offer some sort
  1926.  
  1927.  
  1928.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 34
  1929.  
  1930.  
  1931.  
  1932.  
  1933.      of a freeware-style license for noncommercial use of the RSA
  1934.      algorithm.  However, in December 1991 Mr. Bidzos said he had no plans
  1935.      to ever license the RSA algorithm to PGP users, and denied ever
  1936.      implying that he would.  Meanwhile, I have continued to refrain from
  1937.      distributing PGP, although I've recently updated the PGP User's
  1938.      Guide, and have provided the design guidance for these new revisions
  1939.      of PGP.  Ironically, all this legal controversy from PKP has imparted
  1940.      a forbidden flavor to PGP that has only served to amplify its
  1941.      universal popularity. 
  1942.       
  1943.      I wrote my PGP software from scratch, with my own implementation of
  1944.      the RSA algorithm.  I didn't steal any software from PKP.  Before
  1945.      publishing PGP, I got a formal written legal opinion from a patent
  1946.      attorney with extensive experience in software patents.  I'm
  1947.      convinced that publishing PGP the way I did does not violate patent
  1948.      law.  However, it is a well known axiom in the US legal system that
  1949.      regardless of the law, he with the most money and lawyers prevails, 
  1950.      if not by actually winning then by crushing the little guy with legal
  1951.      expenses.  
  1952.       
  1953.      Not only did PKP acquire the exclusive patent rights for the RSA
  1954.      cryptosystem, which was developed with your tax dollars, but they 
  1955.      also somehow acquired the exclusive rights to three other patents
  1956.      covering rival public key schemes invented by others, also developed
  1957.      with your tax dollars.  This essentially gives one company a legal
  1958.      lock in the USA on nearly all practical public key cryptosystems. 
  1959.      They even appear to be claiming patent rights on the very concept of
  1960.      public key cryptography, regardless of what clever new original
  1961.      algorithms are independently invented by others.  And you thought
  1962.      patent law was designed to encourage innovation!  PKP does not
  1963.      actually develop any software-- they don't even have an engineering
  1964.      department-- they are essentially a litigation company.  
  1965.       
  1966.      Public key cryptography is destined to become a crucial technology in
  1967.      the protection of our civil liberties and privacy in our increasingly
  1968.      connected society.  Why should the Government try to limit access to 
  1969.      this key technology, when a single monopoly can do it for them?  
  1970.       
  1971.      It appears certain that there will be future releases of PGP,
  1972.      regardless of the outcome of licensing problems with Public Key
  1973.      Partners.  If PKP does not license PGP, then future releases of PGP
  1974.      might not come from me.  There are countless fans of PGP outside the
  1975.      US, and many of them are software engineers who want to improve PGP
  1976.      and promote it, regardless of what I do.  The second release of PGP
  1977.      was a joint effort of an international team of software engineers,
  1978.      implementing enhancements to the original PGP with design guidance
  1979.      from me.  It is being released by Peter Gutmann in New Zealand, out
  1980.      of reach of US patent law.  It is being released only in Europe and
  1981.      New Zealand, but it may spontaneously spread to the USA without any
  1982.      help from me or the PGP development team.
  1983.       
  1984.      The IDEA(tm) conventional block cipher used by PGP is covered by a
  1985.      patent in Europe, held by ETH and a Swiss company called Ascom-Tech
  1986.      AG.  The patent number is PCT/CH91/00117.  International patents are
  1987.      pending.  IDEA(tm) is a trademark of Ascom-Tech AG.  There is no
  1988.      license fee required for noncommercial use of IDEA.  Ascom Tech AG
  1989.  
  1990.  
  1991.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 35
  1992.  
  1993.  
  1994.  
  1995.  
  1996.      has granted permission for PGP to use the IDEA cipher, and places no
  1997.      restrictions on using PGP for any purpose, including commercial use. 
  1998.      You may not extract the IDEA cipher from PGP and put it in another
  1999.      commercial product without a license.  Commercial users of IDEA may
  2000.      obtain licensing details from Dieter Profos, Ascom Tech AG, Solothurn
  2001.      Lab, Postfach 151, 4502 Solothurn, Switzerland, Tel +41 65 242885,
  2002.      Fax +41 65 235761.   
  2003.       
  2004.      The ZIP compression routines in PGP come from freeware source code,
  2005.      with the author's permission.  I'm not aware of any patents on the
  2006.      ZIP algorithm, but you're welcome to check into that question
  2007.      yourself.  If there are any obscure patent claims that apply to ZIP,
  2008.      then sorry, you'll have to take care of the patent licensing, not me.
  2009.       
  2010.      All this patent stuff reminds me of a Peanuts cartoon I saw in the
  2011.      newspaper where Lucy showed Charlie Brown a fallen autumn leaf and
  2012.      said "This is the first leaf to fall this year."  Charlie Brown said,
  2013.      "How do you know that?  Leaves have been falling for weeks."  Lucy
  2014.      replied, "I had this one notarized."
  2015.       
  2016.       
  2017.      Licensing and Distribution
  2018.      --------------------------
  2019.       
  2020.      In the USA PKP controls, through US patent law, the licensing of the
  2021.      RSA algorithm.  But I have no objection to anyone freely using or
  2022.      distributing my PGP software, without payment of fees to me.  You must
  2023.      keep the copyright notices on PGP and keep this documentation with
  2024.      it.  However, if you live in the USA, this may not satisfy any legal
  2025.      obligations you may have to PKP for using the RSA algorithm as
  2026.      mentioned above.  
  2027.       
  2028.      In fact, if you live in the USA, and you are not a Federal agency, 
  2029.      you shouldn't actually run PGP on your computer, because Public Key
  2030.      Partners wants to forbid you from running my software.  PGP is
  2031.      contraband.  
  2032.       
  2033.      Of course, I can't give any assurances, but my guess is that it seems
  2034.      unlikely that PKP would waste their time pursuing PGP end users for
  2035.      patent infringement.  There are just too many PGP users to go after. 
  2036.      And why would they single you out?  But I certainly wouldn't want to
  2037.      imply that you do anything improper-- if PKP were offering licenses,
  2038.      I would urge you to obtain one.  But since they aren't, well, I guess
  2039.      you should just refrain from using PGP if you live in the USA.  
  2040.       
  2041.      PGP is not shareware, it's freeware.  Forbidden freeware.  Published
  2042.      as a community service.  If I sold PGP for money, then I would get
  2043.      sued by PKP for using their RSA algorithm.  More importantly, giving
  2044.      PGP away for free will encourage far more people to use it, which
  2045.      hopefully will have a greater social impact.  This could lead to
  2046.      widespread awareness and use of the RSA public key cryptosystem,
  2047.      which will probably make more money for PKP in the long run.  If only
  2048.      they could see that.  
  2049.       
  2050.      All the source code for PGP is available for free under the "Copyleft" 
  2051.      General Public License from the Free Software Foundation (FSF).  A
  2052.  
  2053.  
  2054.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 36
  2055.  
  2056.  
  2057.  
  2058.  
  2059.      copy of the FSF General Public License is included in the source
  2060.      release package of PGP.
  2061.       
  2062.      Regardless of and perhaps contrary to some provisions of the FSF
  2063.      General Public License, the following terms apply:
  2064.       
  2065.      1)  Written discussions of PGP in magazines or books may include
  2066.          fragments of PGP source code and documentation, without 
  2067.          restrictions.
  2068.       
  2069.      2)  Although the FSF General Public License allows non-proprietary
  2070.          derivative products, it prohibits proprietary derivative products. 
  2071.          Despite this, I may grant you a special license if you want to 
  2072.          derive a proprietary commercial product from some of PGP's parts.  
  2073.          There may or may not be a fee depending on what kind of a deal you 
  2074.          plan to pursue with PKP.  Retaining my copyright notice and 
  2075.          attribution might suffice in some cases.  Give me a call and we'll 
  2076.          discuss it.  I'm real easy to please.
  2077.       
  2078.      Feel free to disseminate the complete PGP release package as widely
  2079.      as possible.  Give it to all your friends.  If you have access to any
  2080.      electronic Bulletin Boards Systems, please upload the complete PGP
  2081.      executable object release package to as many BBS's as possible.  You
  2082.      may disseminate the PGP source release package too, if you've got
  2083.      it.  The PGP version 2.1 executable object release package for MSDOS
  2084.      contains the PGP executable software, documentation, sample key rings
  2085.      including my own public key, and signatures for the software and this
  2086.      manual, all in one PKZIP compressed file called PGP21.ZIP.  The PGP
  2087.      source release package for MSDOS contains all the C source files in
  2088.      one PKZIP compressed file called PGP21SRC.ZIP.
  2089.       
  2090.      You may obtain free copies or updates to PGP from thousands of BBS's
  2091.      worldwide or from other public sources such as Internet FTP sites. 
  2092.      Don't ask me for a copy directly from me, since I'd rather avoid
  2093.      further legal problems with PKP at this time.  I might be able to
  2094.      tell you where you can get it, however.  
  2095.       
  2096.      After all this work I have to admit I wouldn't mind getting some fan
  2097.      mail for PGP, to gauge its popularity.  Let me know what you think
  2098.      about it and how many of your friends use it.  Bug reports and
  2099.      suggestions for enhancing PGP are welcome, too.  Perhaps a future PGP
  2100.      release will reflect your suggestions.  
  2101.       
  2102.      This project has not been funded and the project has nearly eaten me
  2103.      alive.  This means you can't count on a reply to your mail, unless
  2104.      you only need a short written reply and you include a stamped
  2105.      self-addressed envelope.  But I do reply to E-mail.  Please keep it in
  2106.      English, as my foreign language skills are weak.  If you call and I'm
  2107.      not in, it's best to just try again later.  I usually don't return
  2108.      long distance phone calls, unless you leave a message that I can call
  2109.      you collect.  If you need any significant amount of my time, I am
  2110.      available on a paid consulting basis, and I do return those calls.
  2111.       
  2112.      The most inconvenient mail I get is for some well-intentioned person
  2113.      to send me a few dollars asking me for a copy of PGP.  I can't send
  2114.      it to them because of the legal threats from PKP (or worse--
  2115.  
  2116.  
  2117.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 37
  2118.  
  2119.  
  2120.  
  2121.  
  2122.      sometimes these requests are from foreign countries, and I would be
  2123.      risking violating cryptographic export control laws).  Even if there
  2124.      were no legal hassles involved in sending PGP to them, they usually
  2125.      don't send enough money to make it worth my time ($50 might be worth
  2126.      my time if I were actually selling this stuff).  I'm just not set up
  2127.      as a low cost low volume mail order business.  I can't just ignore
  2128.      the request and keep the money, because they probably regard the
  2129.      money as a fee for me to fulfill their request.  If I return the
  2130.      money, I might have to get in my car and drive down to the post
  2131.      office and buy some postage stamps, because these requests rarely
  2132.      include a stamped self-addressed envelope.  And I have to take the
  2133.      time to write a polite reply that I can't do it.  If I postpone the
  2134.      reply and set the letter down on my desk, it might be buried within
  2135.      minutes and won't see the light of day again for months.  Multiply
  2136.      these minor inconveniences by the number of requests I get, and you
  2137.      can see the problem.  Isn't it enough that the software is free?  It
  2138.      would be nicer if people could try to get PGP from any of the myriad
  2139.      other sources.  If you don't have a modem, ask a friend to get it for
  2140.      you.  If you can't find it yourself, I don't mind answering a quick
  2141.      phone call. 
  2142.       
  2143.      If anyone wants to volunteer to improve PGP, please let me know.  It
  2144.      could certainly use some more work.  Some features were deferred to
  2145.      get it out the door.  A number of PGP users have since donated their
  2146.      time to port PGP to Unix on Sun SPARCstations, to Ultrix, to VAX/VMS,
  2147.      to OS/2, to the Amiga, and to the Atari ST.  Perhaps you can help
  2148.      port it to some new environments.  But please let me know if you plan
  2149.      to port PGP, to avoid duplication of effort, and to avoid starting
  2150.      with an obsolete version of the source code.  
  2151.       
  2152.      Because so many foreign language translations of PGP have been
  2153.      produced, most of them are not distributed with the regular PGP
  2154.      release package because it would require too much disk space. 
  2155.      Separate language translation "kits" are available from a number of
  2156.      independent sources, and are sometimes available separately from the
  2157.      same distribution centers that carry the regular PGP release
  2158.      software.  These kits include translated versions of the file 
  2159.      LANGUAGE.TXT, PGP.HLP, and the PGP User's Guide.  If you want to
  2160.      produce a translation for your own native language, contact me first
  2161.      to get the latest information and standard guidelines, and to find out
  2162.      if it's been translated to your language already.
  2163.       
  2164.      Future versions of PGP may have to change the data formats for
  2165.      messages, signatures, keys and key rings, in order to provide
  2166.      important new features.  This may cause backward compatibility
  2167.      problems with this version of PGP.  Future releases may provide
  2168.      conversion utilities to convert old keys, but you may have to dispose
  2169.      of old messages created with the old PGP.
  2170.       
  2171.      If you have access to the Internet, watch for announcements of new
  2172.      releases of PGP on the Internet newsgroups "sci.crypt" and PGP's own
  2173.      newsgroup, "alt.security.pgp".  There is also an interest group
  2174.      mailing list called info-pgp, which is intended for users without
  2175.      access to the "alt.security.pgp" newsgroup.  Info-pgp is moderated by
  2176.      Hugh Miller, and you may subscribe to it by writing him a letter at 
  2177.      info-pgp-request@lucpul.it.luc.edu.  Include your name and Internet
  2178.  
  2179.  
  2180.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 38
  2181.  
  2182.  
  2183.  
  2184.  
  2185.      address.  If you want to know where to get PGP, Hugh can send you a
  2186.      list of Internet FTP sites and BBS phone numbers.  Hugh may also be
  2187.      reached at hmiller@lucpul.it.luc.edu. 
  2188.       
  2189.       
  2190.       
  2191.      Export Controls
  2192.      ---------------
  2193.       
  2194.      The Government has made it illegal in many cases to export good
  2195.      cryptographic technology, and that may include PGP.  They regard this
  2196.      kind of software as munitions.  This is determined by volatile State
  2197.      Department policies, not fixed laws.  I will not export this software
  2198.      out of the US or Canada in cases when it is illegal to do so under US
  2199.      State Department policies, and I assume no responsibility for other
  2200.      people exporting it on their own.
  2201.       
  2202.      If you live outside the US or Canada, I advise you not to violate US
  2203.      State Department policies by getting PGP from a US source.  Since
  2204.      thousands of domestic users got it after its initial publication, it
  2205.      somehow leaked out of the US and spread itself widely abroad, like
  2206.      dandelion seeds blowing in the wind.  If PGP has already found its
  2207.      way into your country, then I don't think you're violating US export
  2208.      law if you pick it up from a source outside of the US.  And there are
  2209.      no import restrictions on bringing cryptographic technology into the
  2210.      USA.
  2211.       
  2212.      Some foreign governments impose serious penalties on anyone inside
  2213.      their country using encrypted communications.  In some countries they
  2214.      might even shoot you for that.  
  2215.       
  2216.       
  2217.       
  2218.  
  2219.  
  2220.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 39
  2221.  
  2222.  
  2223.  
  2224.  
  2225.       
  2226.      Recommended Introductory Readings
  2227.      =================================
  2228.       
  2229.      1)  Dorothy Denning, "Cryptography and Data Security", Addison-Wesley,
  2230.          Reading, MA 1982
  2231.      2)  Dorothy Denning, "Protecting Public Keys and Signature Keys",
  2232.          IEEE Computer, Feb 1983
  2233.      3)  Martin E. Hellman, "The Mathematics of Public-Key Cryptography," 
  2234.          Scientific American, August 1979
  2235.       
  2236.      Other Readings
  2237.      ==============
  2238.       
  2239.      4)  Ronald Rivest, "The MD5 Message Digest Algorithm", MIT Laboratory
  2240.          for Computer Science, 1991
  2241.      5)  Xuejia Lai, "On the Design and Security of Block Ciphers", 
  2242.          Institute for Signal and Information Processing, ETH-Zentrum, 
  2243.          Zurich, Switzerland, 1992
  2244.      6)  Xuejia Lai, James L. Massey, Sean Murphy, "Markov Ciphers and 
  2245.          Differential Cryptanalysis", Advances in Cryptology- EUROCRYPT'91
  2246.      7)  Philip Zimmermann, "A Proposed Standard Format for RSA 
  2247.          Cryptosystems", Advances in Computer Security, Vol III, edited by
  2248.          Rein Turn, Artech House, 1988
  2249.       
  2250.       
  2251.       
  2252.      To Contact the Author
  2253.      =====================
  2254.       
  2255.      Philip Zimmermann may be reached at:
  2256.       
  2257.      Boulder Software Engineering
  2258.      3021 Eleventh Street
  2259.      Boulder, Colorado 80304  USA
  2260.      Phone 303-541-0140 (voice or FAX)  (10:00am - 7:00pm Mountain Time)
  2261.      Internet:  prz@sage.cgd.ucar.edu
  2262.       
  2263.       
  2264.       
  2265.  
  2266.  
  2267.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 40
  2268.  
  2269.  
  2270.  
  2271.  
  2272.       
  2273.      Where to Get PGP
  2274.      ================
  2275.       
  2276.      The following describes how to get the freeware public key
  2277.      cryptographic software PGP (Pretty Good Privacy) from an anonymous
  2278.      FTP site on Internet, or from other sources.  
  2279.       
  2280.      PGP has sophisticated key management, an RSA/conventional hybrid 
  2281.      encryption scheme, message digests for digital signatures, data
  2282.      compression before encryption, and good ergonomic design.  PGP is
  2283.      well featured and fast, and has excellent user documentation.  Source
  2284.      code is free.
  2285.       
  2286.      PGP uses the RSA cryptosystem which is claimed by a US patent held by
  2287.      a company called Public Key Partners.  PGP users outside the US take
  2288.      note that there is no RSA patent outside the US.  Also, bear in mind
  2289.      that there are US and Canadian export laws prohibiting anyone inside
  2290.      the US and Canada from exporting cryptographic software like this. 
  2291.      If you live outside the US, you're probably not violating US export
  2292.      law if you pick it up from a source outside of the US.
  2293.       
  2294.      What follows is a small sample of places that allegedly have PGP, as
  2295.      of 3 December 1992.  This information is not guaranteed to be
  2296.      correct.
  2297.       
  2298.      There are two compressed archive files in the PGP 2.1 MSDOS release. 
  2299.      You must get pgp21.zip which contains the MSDOS binary executable and
  2300.      the PGP User's Guide, and you can optionally get pgp21src.zip which
  2301.      contains the source files.  These files can be decompressed with the
  2302.      MSDOS shareware archive decompression utility PKUNZIP.EXE.  For Unix
  2303.      users who lack an implementation of UNZIP, the source code can also
  2304.      be found in the compressed tar file pgp21src.tar.Z.
  2305.       
  2306.      A reminder:  Set mode to binary or image when doing an FTP transfer.
  2307.      Here are a few Internet sites that have PGP via anonymous FTP:
  2308.          
  2309.      Finland:    nic.funet.fi  (128.214.6.100)
  2310.                  Directory: /pub/unix/security/crypt/
  2311.       
  2312.      Italy:      ghost.dsi.unimi.it  (149.132.2.1)
  2313.                  Directory: /pub/security/
  2314.       
  2315.      USA:        pencil.cs.missouri.edu  (128.206.100.207)
  2316.                  Directory: /pub/crypt/
  2317.       
  2318.      For those lacking FTP connectivity to the net, nic.funet.fi also
  2319.      offers the files via email.  Send the following mail message to
  2320.      mailserv@nic.funet.fi:
  2321.       
  2322.          ENCODER uuencode
  2323.          SEND pub/unix/security/crypt/pgp21src.zip
  2324.          SEND pub/unix/security/crypt/pgp21.zip
  2325.       
  2326.      This will deposit the two zipfiles, as (about) 15 batched messages in
  2327.      your mailbox within about 24 hours.  Save and uudecode.
  2328.  
  2329.  
  2330.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 41
  2331.  
  2332.  
  2333.  
  2334.  
  2335.       
  2336.      In the US, PGP may be found on God knows how many BBS systems, far
  2337.      too many to list here.  Still, if you don't have any local BBS phone
  2338.      numbers handy, here are some BBS's you might try.
  2339.       
  2340.      The GRAPEVINE BBS in Little Rock Arkansas has set up a special
  2341.      account for people to download PGP for free.  The SYSOP is Jim Wenzel,
  2342.      at jim.wenzel@grapevine.lrk.ar.us.  The following phone numbers are
  2343.      applicable and should be dialed in the order presented (i.e., the
  2344.      first one is the highest speed line):  (501) 753-6859, (501)
  2345.      753-8121, (501) 791-0124.  When asked to login use the following
  2346.      information:
  2347.       
  2348.          name: PGP USER        ('PGP' is 1st name, 'USER' is 2nd name)
  2349.          password: PGP
  2350.       
  2351.      The Northern Lights BBS in Troy, NY, has PGP for free download.  It
  2352.      is run by Daniel Ray.  Call (518) 237-2163 at 300-2400 bps 8N1.  Then
  2353.      login directly to the pgp account as follows:
  2354.       
  2355.          tnllogin: pgp
  2356.          Password: key
  2357.       
  2358.      In Colorado, try this single-line BBS:  303 443-8292.  It is often
  2359.      busy, so keep trying.  Log in with your own name.
  2360.       
  2361.      PGP is also widely available on Fidonet, a large informal network of
  2362.      PC-based bulletin board systems interconnected via modems.  Check
  2363.      your local bulletin board systems.  It is available on many foreign
  2364.      and domestic Fidonet BBS sites.
  2365.       
  2366.      In New Zealand, try this (supposedly free) dial-up BBS system:
  2367.         Kappa Crucis:  +64 9 817-3714, -3725, -3324, -8424, -3094, -3393
  2368.       
  2369.      For information on PGP implementations on the Apple Macintosh,
  2370.      contact Eric Hughes, at hughes@soda.berkeley.edu, phone (510)
  2371.      849-4729.  For information on PGP on the Commodore Amiga and 
  2372.      Atari ST, or any other questions about where to get PGP for any
  2373.      other platform, contact Hugh Miller at hmiller@lucpul.it.luc.edu.
  2374.       
  2375.      Here are a few people and their email addresses or phone numbers you
  2376.      can contact in some countries to get information on local PGP 
  2377.      availability:
  2378.       
  2379.      Peter Gutmann                 Hugh Kennedy
  2380.      pgut1@cs.aukuni.ac.nz         70042.710@compuserve.com
  2381.      New Zealand                   Germany
  2382.       
  2383.      Branko Lankester              Miguel Angel Gallardo
  2384.      lankeste@fwi.uva.nl           gallardo@batman.fi.upm.es
  2385.      +31 2159 42242                (341) 474 38 09
  2386.      The Netherlands               Spain
  2387.       
  2388.      Hugh Miller                   Eric Hughes
  2389.      hmiller@lucpul.it.luc.edu     hughes@soda.berkeley.edu
  2390.      (312) 508-2727                (510) 849-4729
  2391.  
  2392.  
  2393.      PGPDOC2.TXT            Friday, December  4, 1992 3:02 pm            Page 42
  2394.  
  2395.  
  2396.  
  2397.  
  2398.      USA                           USA
  2399.       
  2400.      Jean-loup Gailly
  2401.      jloup@chorus.fr
  2402.      France
  2403.       
  2404.       
  2405.